Skip to main content

Network Tasks

Network diagnostics and connectivity testing.

network.ping

Display Name: Ping

Send ICMP ping packets to check if a host is reachable and measure latency.

Parameters

NameTypeRequiredDescription
hoststringYesHostname or IP address to ping.
countnumberNoNumber of packets to send. Default: 3.

Output

NameTypeDescription
reachablebooleanTrue if any packets were received.
packet_lossnumberPercentage of packets lost.
avg_latencynumberAverage round-trip time in milliseconds.

network.dns

Display Name: DNS Lookup

Look up DNS records for a domain.

Parameters

NameTypeRequiredDescription
domainstringYesDomain name to query.
typestringNoDNS record type. Options: A, AAAA, CNAME, MX, TXT, NS. Default: A.

Output

NameTypeDescription
domainstringQueried domain.
typestringQueried record type.
answeranyDNS query results.

network.tcp

Display Name: TCP Check

Test if a host and port are reachable over TCP. Optionally send a payload and read the response.

Parameters

NameTypeRequiredDescription
hoststringYesHostname or IP address.
portstringYesTCP port number.
timeoutstringNoConnection timeout. Default: 5s.
messagestringNoPayload to send after connecting.
read_timeoutstringNoTimeout for reading a response.

Output

NameTypeDescription
hoststringChecked host.
portstringChecked port.
reachablebooleanTrue if connection succeeded.
responsestringResponse from the server (if any).
errorstringError message (if any).

network.ssl

Display Name: SSL Check

Check SSL/TLS certificate validity and expiration for a host.

Parameters

NameTypeRequiredDescription
hoststringYesHostname to check.
portstringNoPort. Default: 443.

Output

NameTypeDescription
subjectstringCertificate subject (Common Name).
issuerstringCertificate issuer (Common Name).
not_afterstringExpiration date (RFC3339).
validbooleanTrue if the certificate is currently valid.

network.traceroute

Display Name: Traceroute

Trace the network path to a host to diagnose routing issues.

Parameters

NameTypeRequiredDescription
hoststringYesDestination hostname or IP.
max_hopsnumberNoMaximum TTL (hops). Default: 30.

Output

NameTypeDescription
hopsarrayList of hops with IP and latency.
rawstringRaw traceroute output.

network.whois

Display Name: Whois

Look up domain registration and ownership details.

Parameters

NameTypeRequiredDescription
domainstringYesDomain name to query.
serverstringNoSpecific WHOIS server to query.

Output

NameTypeDescription
rawstringRaw WHOIS response text.
serverstringThe WHOIS server that answered.

network.ntp

Display Name: NTP Check

Check if a server's clock is in sync with an NTP time server.

Parameters

NameTypeRequiredDescription
hoststringNoNTP server hostname. Default: pool.ntp.org.
portstringNoNTP port. Default: 123.
timeoutstringNoTimeout. Default: 5s.

Output

NameTypeDescription
serverstringNTP server used.
drift_secondsnumberTime difference in seconds (local time minus NTP time).