• EnglishEspañol日本語한국어Português
  • ログイン今すぐ開始

この機械翻訳は、参考として提供されています。

英語版と翻訳版に矛盾がある場合は、英語版が優先されます。詳細については、このページを参照してください。

問題を作成する

StatsDモニタリングの統合

StatsD の統合により、 StatsD-format data を New Relic に簡単に取り込むことができます。また、データに任意のタグ(キーと値のペア)を追加することもできます。メトリクスが New Relic に取り込まれると、 データを照会したり、 カスタムチャートやダッシュボードを作成することができます。

StatsDインテグレーションを試してみませんか? New Relicアカウントを作成してください 無料でご利用いただけます。クレジットカードは必要ありません。

要件

この統合では、メトリクス APIイベント API を使用してデータを取り込みます。 これらの API を使用するには、 が必要です。

この統合は、Metric API の 要件とデータ制限に従います。レート制限に達しているかどうかを確認するには、次の NrIntegrationError イベントの NRQL クエリを実行します。

SELECT count(*) FROM NrIntegrationError
WHERE newRelicFeature = 'Metrics'
FACET category, message
LIMIT 100 SINCE 1 day ago

統合は、amd64およびarm64アーキテクチャ用のDockerHubでLinuxコンテナイメージとして利用できます。

インストール

ここでは、標準的なインストールの方法を説明します。KubernetesでStatsDを動作させたい場合は、 Kubernetes install をご覧ください。

StatsD 統合をインストールするには、 New Relic アカウント IDを含めて次のコマンドを実行します。 これにより、 gostatsdで使用される TOML 設定ファイルが生成されます。

bash
$
docker run \
>
-d --restart unless-stopped \
>
--name newrelic-statsd \
>
-h $(hostname) \
>
-e NR_ACCOUNT_ID=YOUR_ACCOUNT_ID \
>
-e NR_API_KEY=NEW_RELIC_LICENSE_KEY \
>
-p 8125:8125/udp \
>
newrelic/nri-statsd:latest

組織が EU データセンター地域にある場合は、これを上記のコマンドに追加します。

bash
$
-e NR_EU_REGION=true \

インストール後は

Kubernetesへのインストール

ここでは、デプロイメントとサービスオブジェクトのためのKubernetesマニフェストの例を紹介します。

このドキュメントはインストールの役に立ちましたか?

設定

インストール手順では、環境変数を使用してnri-statsdを実行します。これにより、TOML構成ファイルが生成されます。さらに、次の構成オプションを設定できます。

設定オプション

説明

expiry-interval

ストリング

この期間、指標が更新されない場合、その指標の報告を停止します。デフォルトは5mです。

フラッシュ間隔の間に値が更新された場合にのみメトリックを送信する場合は、これを1msに構成します。メトリックを期限切れにしないようにするには、 0に設定します。

percent-threshold

整数のリスト

メトリックの集計に使用されるパーセンタイルを指定します。デフォルト: 90

metrics-addr

ストリング

メトリックをリッスンするアドレスを示します。 デフォルト: :8125 。 nri-statsd v2.3.0 (goStatsD v34.2.1 ) からは、Unix ドメイン ソケット (UDS) 経由の接続がサポートされています。 設定では[host]:portの代わりにmetrics-addr=/some/path/newrelic-statsd.socketを使用してください。

ヒント

StatsD統合を使用してFedRAMPコンプライアンスを確保するには、カスタム構成で以下のエンドポイントを定義する必要があります。

address = 'https://gov-insights-collector.newrelic.com/v1/accounts/$NR_ACCOUNT_ID/events'
address-metrics = 'https://gov-infra-api.newrelic.com/metric/v1'

ここでは、デフォルトの設定を上書きして設定をカスタマイズする例を紹介します。

メトリックフォーマット

インテグレーションは、 StatsD プロトコル を使用してメトリクスを受信します。オプションで、サンプルレートを設定したり、タグを追加することができます。

ここでは、私たちが使用しているメトリックデータのフォーマットを紹介します。

<metric name>:<value>|<type>|@<sample rate>|#<tags>

ここでは、これらの分野について説明します。

フィールド名

説明

<metric name>

ストリング

Required. メトリクスの名前。

<value>

ストリング

Required. メトリクスのタイプ:

  • c = counter
  • g = gauge
  • ms = timer

@<sample rate>

浮く

Optional 単純なカウンターまたはタイマーカウンターの場合。 多数のメトリクスを送信する必要がある場合は、サンプリングを使用してネットワーク トラフィックを削減できます。 欠点は、データの解像度が低下することです。

1未満のサンプルレートでこれがどのように機能するかの例:これを0.1に設定すると、カウンターは10回に1回の測定値を送信します。

#<tags>

ストリング

Optional. メトリクスに付加されたタグは属性 (キーの値のペア) に変換されます。 タグ付けオプションの詳細については、 「タグ」を参照してください。

メトリックのタイプ

ここでは、メトリクスの種類とそのフォーマットをご紹介します。

タグ(属性)の追加

データにタグを追加することができます。タグは 属性 (キーと値のペア)として保存されます。タグの追加には2つのオプションがあります。

  • すべてのメトリクスに適用されるデフォルトのタグを追加します。これらは、すべてのメトリクスに適用されます。これらは固定されており、時間が経っても変化しません。
  • メトリクスレベルのタグを追加します。このタグは特定のメトリクスに適用され、2回のサブミットの間に値を変更することができます。

以下は、カスタムタグを含む NRQL クエリの例です。

SELECT count(*) FROM Metric WHERE environment = 'production'

アラートの作成

NRQLのアラート条件 を使ってStatsDのデータにアラートを出すことができます。

データを見つけて使用する

データを照会するには、New Relic の クエリオプション を使用します。例えば、 NRQL のようなクエリを実行します。

SELECT count(*) FROM Metric WHERE metricName = 'myMetric' and environment = 'production'

Metricデータ型をクエリする方法の詳細については、「メトリックデータのクエリ」を参照してください。

トラブルシューティング

問題

StatsD 統合を実行する手順に従いましたが、New Relic で予想されるメトリクスを確認する必要があります。

解決策:

設定のトラブルシューティングを行うには、次の手順に従ってください。

  • に 40 桁の 16 進数文字のライセンスキーが含まれていること、およびそれが選択した New Relic アカウント ID の有効なライセンスであることを確認してください。
  • New Relic アカウントに適切なデータセンター (US または EU) が選択されていることを確認してください。 ヒント: License_key が「eu」で始まる場合は、 NR_EU_REGION=trueフラグを使用する必要があります。
  • StatsD 統合に関連するNrIntegrationErrorがないことを確認してください。
  • 詳細ログは、環境変数NR_STATSD_VERBOSEを使用して有効にできます。 docker run コマンドを変更して変数-e NR_STATSD_VERBOSE=trueを追加します。
  • テスト メトリクスをプッシュして、インテグレーションが期待どおりのメトリクスを送信していることを確認できます。 NetCat ncユーティリティを使用した例:
    • echo "example.gauge:123|g" | nc -u -w0 127.0.0.1 8125 (実行中のコンテナ IP/アドレスで127.0.0.1を更新します)。

ソースコードを確認してください

この統合はオープン ソース ソフトウェアです。つまり、ソース コードを参照して改善を送信したり、独自のフォークを作成してビルドしたりできます。

Copyright © 2024 New Relic株式会社。

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.