ダイヤルインテレメトリ接続を確立する

このトピックでは、ダイヤルインテレメトリ接続を確立する手順について説明します。gRPC サービスとデータコレクターを設定し、Junos デバイスから収集するセンサー情報に基づいてセンサーパスを選択します。

ダイヤルインテレメトリ接続を確立するには、次の手順を使用します。gRPC サービスとデータコレクターを設定し、Junos デバイスから収集するセンサー情報に基づいてセンサーパスを選択します。ダイヤルインモードでは、データコレクターがネットワークデバイスへの接続を開始し、テレメトリデータにサブスクライブします。コレクターとデバイスがセッションを確立します。その後、デバイスはデータをコレクターにストリーミングし、ストリーミング間隔を設定できます。単一の構成および運用データチャネルを必要とするオペレーターは、多くの場合、ダイヤルインモードを選択します。

前提条件：

ジュニパーデバイスが、Junos Telemetryをサポートする互換性のあるJunos OSバージョンを実行していることを確認します。
gRPC 互換のテレメトリコレクター(Juniper Telemetry Collector、Prometheus、InfluxDB など)を設定して、テレメトリデータを受信して処理します。
ジュニパーのデバイスとコレクターがネットワーク経由で通信できることを確認します(gRPCの場合はTCPポート50051(デフォルト)、またはカスタムポート)。
実装でTLSを使用する場合は、デバイスとコレクターの証明書を準備します。
お使いのジュニパーデバイスでサポートされているセンサーの一覧については、 Junos YANGデータモデルエクスプローラを参照してください。
- 手記：Junos YANG Data Model Explorer は、23.2R2-S2 リリースで導入されました。リリース 20.2R1 から 23.1R1 までは、センサー情報を Junos Telemetry Sensor Explorer で確認できます。
gRPC サービスを構成します。「gRPC サービスの構成」を参照してください。

次の手順に従って、ダイヤルインテレメトリ接続を確立します。

データコレクタの設定

コレクターは、接続を開始する準備ができている必要があります。gRPC クライアントを構成して、Juniper デバイスに接続します。
- IP アドレス:デバイスの管理IP(192.168.1.1)。
- ポート: 50051 (またはカスタムポート)。
- プロトコル:gNMIを使用したgRPCまたはJuniper Juniper® Extension Toolkit JETサブスクリプション。
- 資格情報: TLS が有効になっている場合は、クライアント証明書とキーを指定します。
- サブスクリプション:センサーパス(例:/junos/system/linecard/interface/)とサブスクリプションモード(例:ストリーム)を指定します。
コレクタに gNMI クライアントをインストールして設定します。protobuf 定義がコレクターで使用可能であることを確認します。この情報は、コレクターで受信したセンサーデータをデコードするために必要です。gNMI クライアントは、Git Hub で入手できます( 「gNMI クライアント」を参照)。

次のコマンドを実行します。
gnmic -a <device_ip>:<port> subscribe --path <path> --mode stream
例えば：
gnmic -a 192.168.1.1:50051 subscribe --path /junos/system/linecard/interface/ --mode stream
設定を確認するには、show agent sensors コマンドと show extension-service request-response clients コマンドを使用できます。
データコレクターで、データが受信されているかどうかを確認します。たとえば、Prometheus または Grafana をデータコレクターとして使用する場合は、ログまたは視覚化を確認します。

センサーパスの選択

センサーエクスプローラーとセンサーパスの選択に関するガイドライン

ジュニパーネットワークスの Junos YANGデータモデルエクスプローラを使用して、サポートされているすべてのリソースパス、それに対応するリーフ、およびそれらをサポートするデバイスプラットフォームを表示します。

手記： Junos YANG Data Model Explorer は、23.2R2-S2 リリースで導入されました。リリース 20.2R1 から 23.1R1 までは、センサー情報を Junos Telemetry Sensor Explorer で確認できます。

他のテレメトリセンサーとレガシセンサーに関する特定の情報を検索および表示するには、「レガシセンサーパス」を参照してください。

センサーパスを構成するためのガイドラインとベストプラクティスについては、「センサーパスの探索」を参照してください。

コレクターでデータをデコードする

次の手順を使用して、データをキャプチャし、生データをデコードし、プロトコルバッファーファイルを使用してデータをデコードします。

データをデコードするには、次のようにします。

データをキャプチャします。宛先ストリーミングテレメトリサーバーまたはコレクターで netcat を UDP リスナーモードで実行して、すべての受信データグラムをファイルに保存します。ジュニパーネットワークスデバイスのストリーミングサーバープロファイルで設定された宛先ポート番号を使用します。
手記：
このコマンドは、データグラムを data.gpb という名前のファイルに格納します。このプログラムを実行してデータをキャプチャします。データの受信を停止したい場合は、ブレーク信号(Control + C)を送信してプログラムで停止してください
生データをデコードします。

手記：
この手順は省略可能です。データのエンコードされたメッセージタイプがわかっている場合は、必須ではありません。

data.gpb ファイルからメッセージをデコードします。
2636の下の次の入れ子構造は、センサーの種類を識別します。2636数値は、telemetry_top.proto ファイルで定義されているJuniperNetworksSensorメッセージを識別します。この例では、数値識別子7、logical_port.protoファイルで定義されたLogicalPortメッセージに対応しています。次のステップでこの情報を使用して、より詳細な出力を生成します。

メッセージをデコードしてフィールド名を含めます。プロトコルバッファーコンパイラを decode オプション付きで実行します。さらに、最上位のメッセージ・タイプ (TelemetryStream) と、メッセージ定義 logical_port.proto を持つファイルを指定します。また、プロトコルバッファ(gpb)ライブラリを含める必要があります。