• /
  • ログイン
  • 無料アカウント

本書は、お客様のご参考のために原文の英語版を機械翻訳したものです。

英語版と齟齬がある場合、英語版の定めが優先するものとします。より詳しい情報については、本リンクをご参照ください。

問題を作成する

SNMPモニタリング統合(レガシー)

重要

新製品の Network Performance Monitoring はもうお試しになりましたか?

SNMPNetwork Flows の両方を集めて、 Is it the network? の質問に答える方が早い。

当社のSNMP 統合 は、SNMPでメトリクスを公開するあらゆるアプリケーションを監視します。

統合機能をインストールし、メトリクスの収集を開始するためにYAMLファイルを設定する方法をご紹介します。このドキュメントには、開始するのに役立つサンプルYAMLファイルも含まれています。

互換性および要件

当社のインテグレーションは、SNMPバージョン2または3に対応しています。

インテグレーションをインストールする前に、以下の要件を満たしていることを確認してください。

インストールと有効化

SNMPインテグレーションをインストールするには、お使いの環境に応じた手順に従ってください。

追加の注:

設定

インテグレーションの設定

インストールの方法により、インテグレーションの設定方法はいくつかあります。

インテグレーションのYAML形式設定では、必要なログインクレデンシャルやデータの収集方法を設定できます。どのオプションを変更するかは、設定とプリファレンスにより異なります。

設定ファイルには、 intervaltimeoutinventory_source など、すべての統合に適用される共通の設定があります。これらの共通設定については、 Configuration Format のドキュメントを参照してください。

重要

従来の設定/定義ファイルをまだお使いの場合は、こちらの ドキュメント を参考にしてください。

SNMPに関連する特定の設定は、コンフィギュレーションファイルの env セクションを使用して定義されます。これらの設定は、SNMPインスタンスへの接続や、その他のセキュリティ設定や機能を制御します。有効な設定のリストは、このドキュメントの次のセクションで説明します。

SNMP インスタンス設定

SNMPインテグレーションでは、メトリクス情報とインベントリ情報の両方を収集します。収集するメトリクスの種類は、 メトリクスコレクションファイル に追加された情報によって決定されます。

設定

説明

デフォルト

SNMP_HOST

SNMPが動作しているホスト名またはIP。

localhost

SNMP_PORT

SNMPが待ち受けているポート。

161

タイムアウト

リクエストのタイムアウトを秒単位で指定します。

10

RETRIES

タイムアウトした場合の再試行回数。

0

exponential_timeout

再試行のたびにタイムアウト値が2倍になります。

false

V3

SNMPバージョン3を使用します。

false

コミュニティー

SNMPコミュニティ文字列です。SNMP v2の場合のみ。

公開

ユーザー名

v3ユーザーのセキュリティ識別子。SNMP v3の場合のみ。

該当なし

SECURITY_LEVEL

セキュリティレベル。SNMP v3の場合のみ。
有効なオプションは以下のとおりです。

  • noAuthnoPriv
  • authNoPriv
  • authPriv

該当なし

AUTH_PROTOCOL

認証プロトコル。SNMP v3の場合のみ。
有効なオプションは以下のとおりです。

  • MD5
  • SHA

MD5

auth_passphrase

認証用の鍵を生成する際に使用するパスワード。SNMP v3の場合のみ。

該当なし

PRIV_PROTOCOL

暗号化プロトコル。SNMP v3の場合のみ。
有効なオプションは次のとおりです。

  • AES
  • DES

AES

priv_passphrase

メッセージを暗号化するためのキーを生成するためのパスワード。SNMP v3の場合のみ。

該当なし

コレクション_ファイル

メトリックコレクション定義ファイルの完全なファイルパスのコンマ区切りリスト.

該当なし

これらの設定値は、いくつかの方法で定義できます。

  • コンフィグファイルに直接値を追加する。これが最も一般的な方法です。
  • {{}} 表記を使用して環境変数から値を置き換えます。これには、インフラストラクチャ・エージェント v1.14.0+が必要です。詳しくはこちら または、以下の例をご覧ください .
  • シークレット管理を使用する。設定ファイル上で平文で公開されてしまうようなパスワードなどの機密情報を保護するために使用します。詳細については、 Secrets management を参照してください。

メートル単位のコレクションファイル

メトリクス・コレクション定義ファイルは構造化されたYAMLファイルで、どのようなメトリクスを収集するかをインテグレーションに伝えます。構成例については、 メトリクス・コレクション・ファイルの例 を参照してください。

メトリクス収集ファイルのサンプル: /etc/newrelic-infra/integrations.d/snmp-metrics.yml.sample

ヒント

整理やメンテナンスを容易にするために、異なるコレクションファイルを書くことができます。例として、以下の 設定ファイル を参照してください。

デバイス

コレクションファイルは、メトリクスを収集して整理するファイルです。各ファイルには、1つ以上のデバイスを含む1つの collect: ブロックが含まれます。各デバイスには、以下のキーが定義されています。

  • device: メトリクスが収集されているSNMPデバイスの名前。このフィールドは必須です。
  • metrics_sets: このデバイスから収集するメトリクスを整理したメトリクスセットのリスト。 Metric Setsを参照.
  • Inventory: このデバイスから収集し、インベントリとして報告するオブジェクト識別子(OID)のリスト。 インベントリを参照.

メトリックセット

メトリクスセットは、SNMP デバイスから取得し、New Relic に報告する SNMP オブジェクト識別子 (OID) の論理的なグループを表します。各メトリックセットには、以下のキーが定義されています。

  • 名前: メトリックセット名。

  • event_type: このメトリックセットからのコレクションの イベントタイプ の名前。

    イベントタイプのネーミングに関するヒントは、 Naming tips を参照してください。

  • type: メトリックセットのタイプです。SNMPスカラーOIDのメトリックセットを記述するには scalar を、SNMPテーブルからのメトリックに対応するメトリックセットを記述するには table を使用します。

  • root_oid: タイプテーブル の場合、テーブルのルート OID を入力します。統合は、このOIDからSNMPウォークを実行して、テーブルのメトリクスを取得します。

  • インデックス: タイプテーブル の場合、テーブルの行を一意に定義する 1 つ以上のテーブル列インデックス OID を入力します。各インデックスOIDには、以下のキーが定義されています。

    • oid: 収集する OID 名、例えば .1.3.6.1.4.1.52032.1.2.1.1.このフィールドは必須です。
    • 名前: メトリックが New Relic に表示される名前。指定しない場合は、デフォルトでOID名になります。
  • metrics: このメトリックセットの一部として収集されるSNMP OIDのリスト。 スカラーOID または テーブルカラムOID のリストを タイプに応じて入力してください

    • oid :収集するOID名、例えば 1.3.6.1.4.1.52032.1.2.0 。このフィールドは必須です。
    • metric_name: メトリックが New Relic に表示される名前。指定されていない場合は、デフォルトでOID名になります。
    • metric_type: この属性を収集するNew Relicのメトリックタイプ。オプションは gauge, delta, pdelta, rate, prate または attribute 。指定されていない場合、統合はメトリックのタイプを推測しようとします。

インベントリ

Inventory」は、インベントリアイテムとして収集・報告されるSNMPオブジェクト識別子(OID)の配列です。各OIDに対して、以下のキーが定義されています。

  • oid: 収集する OID 名、例えば 1.3.6.1.4.1.52032.1.4.0.このフィールドは必須です。
  • category: インベントリアイテムが New Relic に表示されるカテゴリー名。このフィールドは必須です。
  • name: インベントリアイテムが New Relic で表示される名前。このフィールドは必須です。

設定の例

オンホストインテグレーション設定の一般的な構成の詳細については、設定を参照してください。

データのネーミングのコツ

メトリクスは、サンプルの形で送信・保存されます。これは、メトリックデータとメタデータを含むキーと値のペアのリストです。各サンプルは、New Relic のイベントデータベースに イベント として保存されます。

New Relic に報告される SNMP データの作成と命名はお客様の責任です。このため、New Relic では、イベントタイプの名前を付ける際に、これらの規約に従うことを強く推奨します。一貫した命名法を行うために。

  • キャメルケースを使う。
  • どのようなデータが含まれているのかが明確にわかるような名称を使用してください。

例: MyorgApplicationSample

推奨: 異なるアプリケーション間で類似したメトリクスに同じ命名法を使用する。

データの検索と使用

このサービスからのデータは、収集されたサンプルが一般的に監視対象のデバイスに固有のものであるため、統合ダッシュボードには報告されません。 独自のダッシュボードを構築する必要があります

SNMP メトリクスは、 構成ファイル で指定されたユーザー定義の イベントタイプ に添付されます。 このデータを照会して トラブルシューティングの目的で使用したり、カスタムチャートやダッシュボードを作成することができます。

データの検索・使用方法の詳細については、 インテグレーションデータを理解するを参照してください。

メトリックデータ

統合によって生成されたメトリクスには、収集元のコレクションに関連するメタデータが含まれています。このメタデータは、 NRQL クエリ で使用して、クエリが目的のメトリックセットのデータのみを返すように、データをフィルタリングしてファセットする必要があります。

各イベントには、以下のメタデータが含まれています。

名前

説明

デバイス

これらのメトリクスのデバイス名です。

ホスト

メトリクスが収集されているSNMPホストです。

port

メトリクスが収集されているSNMPポートです。

表示名

これらのメトリックのメトリックセット名です。

インベントリデータ

SNMP インテグレーションの設定パラメータを取得します。このデータは、Infrastructure Inventoryページconfig/snmp ソースの下にあります。インベントリデータの詳細については、 Understand integration data を参照してください。

トラブルシューティング

トラブルシューティングのヒント

ソースコードのチェック

このインテグレーションは、オープンソース・ソフトウェアです。つまり、 そのソースコードを閲覧して 改良を送ったり、独自のフォークを作成して構築することができます。

問題を作成する
Copyright © 2022 New Relic Inc.