Icmpcheck Receiver
Supported Telemetry
Overview
Configuration
The following configuration settings are available:targets(required): The list of targets to be pinged.collection_interval(optional, default =60s): This receiver collects metrics on an interval. Valid time units arens,us(orยตs),ms,s,m,h.initial_delay(optional, default =1s): Defines how long this receiver waits before starting.
Target Configuration
Each target has the following properties:host(required): A hostname or IP address to be pinged.ping_count(optional, default =3): The number of packets after which the pinger is stopped.ping_interval(optional, default =1s): The wait time between each packet send.ping_timeout(optional, default =5s): Specifies a timeout before ping exits, regardless of how many packets have been received.
Optional Metrics Configuration
Each metric can be enabled or disabled individually. By default, all metrics are enabled. Example:Metrics
Details about the metrics produced by this receiver can be found in documentation.mdResource Attributes
The following attributes are added to all reported resources:net.peer.ip- the IP address of the host being pinged.net.peer.name- the string address of the host being pinged.
Example Configuration
Metrics
| Metric Name | Description | Unit | Type | Attributes |
|---|---|---|---|---|
โ
ping.loss.ratio | The percentage of lost packets. | % | Gauge | |
โ
ping.rtt.avg | Average round-trip time in milliseconds. | ms | Gauge | |
โ
ping.rtt.max | Maximum round-trip time in milliseconds. | ms | Gauge | |
โ
ping.rtt.min | Minimum round-trip time in milliseconds. | ms | Gauge | |
โ
ping.rtt.stddev | Standard deviation of round-trip time in milliseconds. | ms | Gauge |
Resource Attributes
| Attribute Name | Description | Type | Enabled |
|---|---|---|---|
net.peer.ip | The IP address of the host being pinged. | string | โ |
net.peer.name | The hostname of the host being pinged. | string | โ |
Last generated: 2026-04-13