New announcements from Dash: Incident Management, Continuous Profiler, and more! New announcements from Dash!


Agent Check Agent Check

Supported OS: Linux Mac OS Windows


Get metrics from gnatsd_streaming service in real time to:

  • Visualize and monitor gnatsd_streaming states
  • Be notified about gnatsd_streaming failovers and events.



If you are using Agent v6.8+ follow the instructions below to install the gnatsd_streaming check on your host. See our dedicated Agent guide for installing community integrations to install checks with the Agent prior v6.8 or the Docker Agent:

  1. Install the developer toolkit.
  2. Clone the integrations-extras repository:

    git clone
  3. Update your ddev config with the integrations-extras/ path:

    ddev config set extras ./integrations-extras
  4. To build the gnatsd_streaming package, run:

    ddev -e release build gnatsd_streaming
  5. Download and launch the Datadog Agent.

  6. Run the following command to install the integrations wheel with the Agent:

    datadog-agent integration install -w <PATH_OF_GNATSD_STREAMING_ARTIFACT_>/<GNATSD_STREAMING_ARTIFACT_NAME>.whl
  7. Configure your integration like any other packaged integration.


  1. Edit the gnatsd_streaming.d/conf.yaml file in the conf.d/ folder at the root of your Agent’s configuration directory to start collecting your GnatsD streaming metrics. See the sample gnatsd_streaming.d/conf.yaml for all available configuration options.

  2. Restart the Agent


Run the Agent’s status subcommand and look for gnatsd_streaming under the Checks section.


The gnatsd_streaming check is compatible with all major platforms

Data Collected


The number of currectly connectied clients
Shown as unit
The number of subscriptions the server has handled
Shown as unit
The number of currently active channels
Shown as unit
The total number of messages passed through the server
Shown as unit
The total number of bytes passed through the server
Shown as byte
The total number of messages passed through the store
Shown as unit
The total number of bytes passed through the store
Shown as byte
The number of clients connected
Shown as unit
The number of channels open
Shown as unit
The total count of messages in a channel
Shown as unit
The total bytes of messages in a channel
Shown as byte

Nats Streaming Server metrics are tagged with names like “nss-cluster_id”


If you are running Nats Streaming Server in a Fault Tolerant group a Nats Streaming Failover event will be issued when the status of a Server changes between FT_STANDBY and FT_ACTIVE

Service Checks

This gnatsd_streaming check tags all service checks it collects with:

  • server_name:<server_name_in_yaml>
  • url:<host_in_yaml>

gnatsd_streaming.can_connect: Returns CRITICAL if the Agent fails to receive a 200 from the monitoring endpoint, otherwise returns OK.


Need help? Contact Datadog support.