Analyzer signal-watcher

# Name

signal-watcher - Sent or Received signals

This analyzer monitors signal transmission and reception across processes in the system. It tracks signals sent to and received by target processes, capturing signal types, sender and receiver process information, and timestamps. The analyzer provides detailed logs of signal activity, helping diagnose issues related to process communication, unexpected terminations, and signal handling behavior. This is useful for troubleshooting application crashes, debugging inter-process communication, and understanding signal-based process management.

# Resource Category

Miscellaneous.

# Application Type & Technical Stack

• All

# Command Line Syntax

The analyzer can be invoked directly on the command-line via the orxray utility from the openresty-xray-cli software package.

Alternatively, the analyzer can also be invoked manually or automatically on the web console UI of OpenResty XRay (like on the Advanced web page).

# PID is the target process PID.
orxray analyzer run signal-watcher -p PID

# trace a shell command directly
orxray analyzer run signal-watcher -c SHELL_CMD

# PGID is the process group ID or any process's PID within the target process
# group.
orxray analyzer run signal-watcher -p -PGID

# trace any processes started from the specified executable path.
orxray analyzer run signal-watcher --exe /path/to/exe/file

# Tracing Multiple Processes

Supported.

# Output Formats

• Plain Texts

# Output Example

{
  "ngx-signals": [
      { "receiver": "resty2", "sender pid": "2122671", "sender": "nginx", "signal": "SIGCHLD", "time": "1764838003", "receiver pid": "2122669" },
      { "receiver": "nginx", "sender pid": "2122780", "sender": "strings-re", "signal": "SIGCHLD", "time": "1764838007", "receiver pid": "2122767" },
      { "receiver": "resty2", "sender pid": "2122875", "sender": "nginx", "signal": "SIGCHLD", "time": "1764838023", "receiver pid": "2122874" }
  ]
}

# Author

The OpenResty Inc. Team.

# Copyright

Copyright (C) by OpenResty Inc. All rights reserved.