Troubleshoot

Run network troubleshooting checks: ICMP ping, DNS resolve, TLS cert verification

Troubleshoot

AI-generated

Summary

Executes ICMP ping, DNS resolution, or TLS certificate verification on a host to determine network connectivity and security configuration.

Inputs

  • action (required) — Troubleshooting action to perform: ping, dnsResolve, or verifyTlsCert
  • host (required) — Hostname or IP address to target
  • pingCount — Number of ICMP echo requests to send (max 100, defaults to 4). Only used when action is ping.
  • pingTimeout — Maximum time in seconds to wait before ping exits (0-300, defaults to 10). Only used when action is ping.
  • dnsRecordType — DNS record type to query (defaults to A). Only used when action is dnsResolve.
  • dnsServer — Optional custom DNS server (defaults to system default). Only used when action is dnsResolve.
  • tlsPort — Port to connect to for TLS verification (defaults to 443). Only used when action is verifyTlsCert.
  • tlsServername — Server name for TLS SNI extension. Defaults to host if empty. Only used when action is verifyTlsCert.
  • tlsRejectUnauthorized — Whether to reject unauthorized or self-signed certificates (defaults to false). Only used when action is verifyTlsCert.

Output shape

A single item per input item containing action, host, timestamp, and result fields specific to the selected action.

Returns success/error flags, packet statistics for ping, resolved records for DNS, or certificate details for TLS. If the node fails, the error message and stack trace are included.

Examples

Example 1: Check if a web server is reachable and measure packet loss.

Action: ping; Host: 192.168.1.10; Ping Count: 5; Ping Timeout: 10 seconds.

Example 2: Query MX records for an email domain using a custom DNS server.

Action: dnsResolve; Host: example.com; DNS Record Type: MX; DNS Server: 8.8.8.8.

Example 3: Validate the TLS certificate of an HTTPS server.

Action: verifyTlsCert; Host: api.example.com; Port: 443; Reject Unauthorized: false.

Links

Discussion