Gnatsd_streaming
セキュリティモニタリングが使用可能です セキュリティモニタリングが使用可能です

Gnatsd_streaming

Supported OS: Linux Mac OS Windows

概要

gnatsd_streaming サービスからメトリクスをリアルタイムに取得して、以下のことができます。

  • gnatsd_streaming の状態を視覚化および監視できます。
  • gnatsd_streaming のフェイルオーバーとイベントの通知を受けることができます。

セットアップ

インストール

Agent v6.8 以降を使用している場合は、以下の手順に従って、ホストに gnatsd_streaming チェックをインストールしてください。バージョン 6.8 以前の Agent または Docker Agent でチェックをインストールする場合は、コミュニティインテグレーションのインストールに関する Agent のガイドを参照してください。

  1. 開発ツールキットをインストールします。
  2. integrations-extras リポジトリを複製します。

    git clone https://github.com/DataDog/integrations-extras.git.
  3. ddev 構成を integrations-extras/ パスで更新します。

    ddev config set extras ./integrations-extras
  4. gnatsd_streaming パッケージをビルドします。

    ddev -e release build gnatsd_streaming
  5. Datadog Agent をダウンロードして起動します。

  6. 次のコマンドを実行して、Agent でインテグレーション Wheel をインストールします。

    datadog-agent integration install -w <PATH_OF_GNATSD_STREAMING_ARTIFACT_>/<GNATSD_STREAMING_ARTIFACT_NAME>.whl
  7. 他のパッケージ化されたインテグレーションと同様にインテグレーションを構成します。

コンフィグレーション

  1. GnatsD のストリーミングメトリクスの収集を開始するには、Agent の構成ディレクトリのルートにある conf.d/ フォルダーの gnatsd_streaming.d/conf.yaml ファイルを編集します。 使用可能なすべての構成オプションの詳細については、サンプル gnatsd_streaming.d/conf.yaml を参照してください。

  2. Agent を再起動します

検証

Agent の status サブコマンドを実行し、Checks セクションで gnatsd_streaming を探します。

互換性

gnatsd_streaming チェックは、すべての主要プラットフォームと互換性があります。

収集データ

メトリクス

gnatsd.streaming.serverz.clients
(gauge)
The number of currectly connectied clients
Shown as unit
gnatsd.streaming.serverz.subscriptions
(count)
The number of subscriptions the server has handled
Shown as unit
gnatsd.streaming.serverz.channels
(gauge)
The number of currently active channels
Shown as unit
gnatsd.streaming.serverz.total_msgs
(count)
The total number of messages passed through the server
Shown as unit
gnatsd.streaming.serverz.total_bytes
(count)
The total number of bytes passed through the server
Shown as byte
gnatsd.streaming.storez.total_msgs
(count)
The total number of messages passed through the store
Shown as unit
gnatsd.streaming.storez.total_bytes
(count)
The total number of bytes passed through the store
Shown as byte
gnatsd.streaming.clientsz.total
(gauge)
The number of clients connected
Shown as unit
gnatsd.streaming.channelsz.total
(gauge)
The number of channels open
Shown as unit
gnatsd.streaming.channelsz.msgs
(count)
The total count of messages in a channel
Shown as unit
gnatsd.streaming.channelsz.bytes
(count)
The total bytes of messages in a channel
Shown as byte

Nats ストリーミングサーバーのメトリクスは、”nss-cluster_id” のような名前でタグ付けされます。

イベント

Nats ストリーミングサーバーをフォールトトレラントグループ内で実行している場合、サーバーのステータスが FT_STANDBYFT_ACTIVE の間で 切り替わると、Nats ストリーミングフェイルオーバーイベントが発行されます。

サービスのチェック

この gnatsd_streaming チェックは、収集するすべてのサービスチェックに次のタグを付けます。

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

gnatsd_streaming.can_connect: Agent が monitoring エンドポイントから 200 を受信できない場合は、CRITICAL を返します。それ以外の場合は、OK を返します。

トラブルシューティング

ご不明な点は、Datadog のサポートチームまでお問合せください。