statsd のモニター

Instana Observability を使用すると、 StatsD プロトコルを利用するアプリケーションやサービスを包括的に監視し、そのパフォーマンスや状態に関する洞察を得ることができます。

まず、 Instana ホストエージェントをインストールします。これは StatsD コレクターデーモンとして機能し、メトリクスを受信するため、別の StatsD デーモンをデプロイする必要がなくなります。 エージェントは、 StatsD センサーを展開します。 「設定 」セクションの手順に従ってセンサーを設定すると、 Instana のUIで、アプリケーションやサービスに関連するメトリクスを確認できるようになります。

サポート情報

StatsD センサーが現在の環境と互換性があるかどうかを確認するには、以下のサポート情報セクションをご確認ください:

対応バージョンとサポート方針

以下の表は、最新のサポート対象バージョンとサポート方針を示しています:

テクノロジー サポート・ポリシー 最新技術バージョン サポートされる最新バージョン
statsd 45 日間 0.10.2 0.10.2

サポートポリシーに関する詳細については、 「センサーのサポート戦略」 を参照してください。

StatsD センサーの設定

デフォルトでは、statsd センサーは無効になっています。 センサーを有効にするには、次の例に示すように <agent_install_dir>/etc/instana/configuration.yaml エージェントの設定ファイルを編集してください:

com.instana.plugin.statsd:
  enabled: true
  ports:
    udp: 8125
    mgmt: 8126
  bind-ip: "0.0.0.0" # all IPs by default
  flush-interval: 10 # in seconds

正規表現を使用して一連のメトリクスを監視するには、以下の構成でStatsDセンサーを構成します:

com.instana.plugin.statsd:
  metricsRegex: '<OPTIONAL_REGEX_HERE>'
注: 通常の statsd サービスは実行しないでください。実行すると、エージェントがこれらのポートでリスニングできなくなります。 サーバー statsd として機能するエージェントのみを実行します。

準備

以下の手順に従って、 Instana StatsD センサーへの UDP ポートが開いているか確認してください:

  1. StatsD センサーを無効にします。
  2. 「 StatsD 」センサーが有効化された Instana エージェントがインストールされているホストで、次のコマンドを実行します:
    nc -l -u 8125
    
  3. その他のコンピューターから、以下のようなコマンドを送信します。
    echo -n "custom.metric.name-test:1|c" | 34.135.37.172 8125
    
  4. ポート 8125 で実行されているリスナーの出力を確認します。 出力は、 Instana エージェントがインストールされているホストのコンソールに表示されます。

メトリックがリスナーの出力に表示される場合、 StatsD への接続が確立されます。 そうでない場合、ホストの UDP ポートは開いていません。

メトリックの表示

クライアントライブラリの標準的な StatsD プロトコルを使用して、 StatsD センサー経由で Instana エージェントにデータを送信する場合、ホストダッシュボードには最大3000個のカスタムメトリクスが表示されます。 エージェントはホスト上のメトリックデータを受信する。

StatsD センサーは、カウンタ、ゲージ、タイマなどのメトリックの種類ごとに、最大 1000 のメトリックを収集できます。

メトリックを表示するには、以下のステップを実行します。

  1. Instana のUIにあるナビゲーションメニューから、 「インフラストラクチャ」 を選択します。
  2. 監視ホストをクリックします。

収集されたすべてのメトリックを含むホスト・ダッシュボードを表示できます。 メトリクスは、 UDP を通じて、 StatsD 形式で設定された UDP ポートに送信されます。 この形式の詳細については、 「 StatsD メトリックタイプ」 を参照してください。

センサーは、以下の StatsD 形式で送信されるメトリックを受け入れます。

  • metric name:value:

    たとえば、次のスクリプトはhitsというカウンタを1つ増やします:

    echo "hits:1|c" | nc -u -w0 127.0.0.1 8125
    
  • \n UDP を介して、設定済みの UDP ポートへ複数のメトリクスを送信するための区切り文字として:

    echo "hits:1|c\nlatency:320|ms\nvisits:333|g\nresponse time:765|s" | nc -u -w0 127.0.0.1 8125
    
  • # タグ:

    echo "host.network_receive_errs_total:10|c|#collector:network,device:utun2,host:testmachine" | nc -u -w0 127.0.0.1 8125