このページの目次
Junos Telemetry Interface での OpenConfig と gRPC について
Junos OS リリース 16.1R3 以降、リモート プロシージャ コール(RPC)インターフェイスのセットを使用して、Junos テレメトリ インターフェイスを設定し、gRPC フレームワークを使用してテレメトリ データをストリーミングできるようになりました。OpenConfigは、マルチベンダーネットワークの設定と管理に、ベンダーに依存しないデータモデルの使用をサポートしています。gRPC は、安全で信頼性の高いデータのトランスポートを提供するオープン ソース フレームワークです。
Junos OSおよびgRPCのOpenConfig は、MXシリーズのMPCおよびJunos OSリリース16.1R3以降のPTXシリーズルーターでのみサポートされています。
Junos OS Release 17.2R1以降、OpenConfigとgRPCは、QFX10000スイッチ、QFX5200スイッチ、PTX1000ルーターでもサポートされています。
Junos OS リリース 17.3R1 以降、Junos テレメトリ インターフェイスは、PTX3000 ルーター、QFX5110 スイッチ、EX4600 および EX9200 スイッチの RCB(ルーティング制御およびボード)でサポートされます。 OpenConfigおよびgRPCは、MX80およびMX104ルーターではサポートされていません。
Junos OSリリース17.4R1以降、MX2008ルーターがサポートされています。
Junos OSリリース18.3R1以降、MXシリーズおよびPTXシリーズルーターでは、gRPCを介してLLDPテレメトリセンサー情報のON_CHANGEストリーミングがサポートされています。
Junos OSリリース18.3R1以降では、QFX5120-48YおよびEX4650スイッチもサポートされます。
Junos OSリリース18.4R1以降、EX4600スイッチもサポートされます。
Junos OSリリース18.4R1以降、MX480、MX960、MX2010、MX2020、MX2008およびMX-ELMルーターもサポートされています。
Junos OS リリース 19.1R1 以降では、MS-MIC および MS-MPC で動作する MX シリーズ ルーター、QFX10002 スイッチ、PTX10002 ルーターもサポートされています。
Junos OS Evolved Release 19.1R1以降、OpenConfig(OC)とJunos telemetry interface(JTI)がサポートされています。gRPC APIとお客様向けCLIは、どちらもJunos OSの場合と同じです。Junos OS の標準として、ネットワークエージェント(NA)と OC パッケージは Junos OS Evolved イメージの一部です。
Junos OS Evolved 19.1R1以降、PTX10003ルーター上のパケット転送エンジンセンサーもサポートされています。
Junos OSリリース19.2R1以降、SRX4100、SRX4200、SRX4600、SRX5400、SRX5600、SRX5800、vSRX仮想ファイアウォールシリーズサービスゲートウェイ。
Junos OSリリース19.2R1以降、パケット転送エンジン統計をストリーミングするgNMIサービスは、MX960、MX2008、MX2010、MX2020ルーター、PTX1000およびPTX10000ルーター、QFX5200スイッチでサポートされています。
Junos OS Release 19.2R1以降、ストリーミング統計用のgNMIサービスは、QFX5110、QFX5120、QFX5200、およびQFX5210スイッチでサポートされています。
Junos OS Release 19.3R1以降、統計情報をエクスポートするgRPCサービスは、MPC10E-10C-MRATEおよびMPC10E-15C-MRATEラインカードをホストするMXシリーズルーターでサポートされています。
Junos OS Evolvedリリース19.3R1以降、統計をエクスポートするためのgRPCサービスが、QFX5220-128CおよびQFX5220-32CDスイッチでサポートされています。
Junos リリース 19.4R1 以降、パケット転送エンジンとルーティング エンジンの統計情報をストリーミングする gRPC サービスが EX4300-MP スイッチでサポートされます。
Junos OS Evolvedリリース19.4R1では、PTX10008ルーターに対するJTIサポートが文書化されていますが、サポートされていません。
Junos リリース 20.R1 以降、パケット転送エンジン統計用のストリーミング テレメトリ センサー向けの gNMI サービスは、MX2010 および MX2020 ルーターの MX2K-MPC11E ライン カードでサポートされます。
Junos OS リリース 20.1R1 以降、gRPC サービス バージョン v1.18.0 が JTI でサポートされます。このバージョンには、gRPC の重要な機能強化が含まれています。Junos OS以前のリリースでは、gRPCバージョンv1.3.0がJTIでサポートされています。
Junos OS Evolved Release 20.2R1以降、NDP統計をストリーミングするgRPCサービスがPTX10001ルーターでサポートされます。
Junos OS Release 20.2R1以降、パケット転送エンジンとルーティングエンジンの統計情報をストリーミングするgRPCサービスが、EX2300、EX2300-MP、EX3400スイッチでサポートされます。
Junos OSリリース20.2R1以降、BGPルーティング情報ベース(RIB)とBGPピア統計をストリーミングするgRPCサービスは、コンテナ化ルーティングプロトコルプロセス(cRPD)をサポートするすべてのプラットフォームファミリーでサポートされます。cRPDは、Junos OSから切り離されたジュニパーのルーティングプロトコルプロセス(rpd)で、Linuxベースの環境で動作するようにDockerコンテナとしてパッケージ化されています。
Junos OSリリース20.2R1以降、gRPCサービスとgNMIサービスを使用したBGPピア統計のエクスポートON_CHANGE、gRPCサービスとgNMIサービスを使用したBGPピア統計のエクスポートが、MX960、MX2008、MX2010、MX2020、PTX1000、PTX5000、PTX10000ルーター、およびQFX5100スイッチとQFX5200スイッチでサポートされます。
Junos OS Release 20.2R1以降、gRPCサービスを使用したBGPグローバル、ピア、およびperrグループの統計情報のストリーミングは、EX2300、EX3400、EX4300、EX4600、EX9200スイッチでサポートされます。
Junos OS リリース 20.2R1 以降、SRX5400、SRX5600、および SRX5800 サービス ゲートウェイで、パケット転送エンジン センサーを介したストリーミング収益インターフェイス統計、およびgRPC サービスと gNMI サービスを使用したルーティング エンジン センサーを介した疑似インターフェイス統計がサポートされます。
Junos OSリリース20.2R1以降、パケット転送エンジンセンサーを介したストリーミング収益インターフェイス統計と、gRPCサービスとgNMIサービスを使用したルーティングエンジンセンサーを介した疑似インターフェイス統計が、SRX5400、SRX5600、およびSRX5800サービスゲートウェイでサポートされます。
Junos OSリリース20.2R1以降、ストリームスタンバイへのセンサー ルーティングエンジンの統計情報は、MX480、MX960、MX10003、MX2010、およびMX2020ルーターでサポートされています。
Junos OS リリース 20.2R1 以降、gRPC サービスを使用して EVPN 統計をストリーミングするセンサーは、QFX5100、QFX5110、QFX5120、QFX5200、QFX10002-60C、QFX10002、QFX10008、および QFX10016 スイッチでサポートされています。
ネットワークエージェントソフトウェア
Junos テレメトリインターフェイス用に gRPC を使用して OpenConfig を実装するには、ジュニパーネットワークスデバイスがアップグレードされた FreeBSD を備えたバージョンの Junos OS を実行している場合、ネットワークエージェントと呼ばれるパッケージをダウンロードしてインストールする必要があります。Junos OS の他のすべてのバージョンでは、ネットワークエージェントの機能がソフトウェアに組み込まれています。ネットワークエージェントは gRPC サーバーとして機能し、OpenConfig RPC インターフェイスを終端します。また、OpenConfig 仕様に従ってテレメトリ データをストリーミングする役割も担います。テレメトリの OpenConfig 仕様を表示するには、 OpenConfig テレメトリの仕様に関するページを参照してください。Junos OS 向け OpenConfig の詳細については、 『 OpenConfig User Guide』を参照してください。
ネットワークエージェントは、サーバーベースの SSL(セキュアソケットレイヤー)認証もサポートしています。クライアントベースの SSL 認証はサポートされていません。SSL 証明書は、ジュニパーネットワークスのデバイスにインストールする必要があります。
ネットワークエージェントパッケージのインストールについて詳しくは、 ネットワークエージェントパッケージのインストールを参照してください。
OpenConfig for Junos OS を使用した Junos テレメトリ インターフェイスの有効化
OpenConfig for Junos OSは、Junos Telemetry interfaceを有効にするためのRPCモデルを指定します。OpenConfig for Junos OS パッケージを、ジュニパーネットワークス デバイスにダウンロードしてインストールする必要があります。このパッケージには、必要なYANGモデルも含まれています。
すべての YANG データ モデルは 、特定の OS の GitHub リポジトリにあり、1 つのダウンロード パッケージでリリースできます。パッケージとリポジトリには、ネイティブ構成、状態、RPC データ モデルと、その OS でサポートされている OpenConfig および IETF データ モデルが含まれています。また、ジュニパーネットワークスのダウンロードサイトからYANGデータモデルにアクセスすることもできます。
Web ブラウザーを使用して、ジュニパーネットワークスの Web ページにある [すべての Junos Platforms ソフトウェアのダウンロード URL:https://www.juniper.net/support/downloads/] に移動します。[ネットワーク管理] タブで、下にスクロールして [OpenConfig] を選択します。[ソフトウェア]タブを選択します。OpenConfig モジュールの適切なバージョンを選択します。Junos OSとアップグレードされたFreeBSDを搭載したデバイス用の2つのバージョンと、他のすべてのバージョンのJunos OSを実行しているデバイス用の2つのバージョンがあります。詳細については、OpenConfigパッケージのインストールおよび Junos OS YANGモジュールについてを参照してください。
ネットワークエージェントパッケージによってインストールされるプログラムインターフェイス OpenConfigTelemetry は、テレメトリ gRPC サービスを定義します。RPC は telemetrySubscribe 、次のサブスクリプション パラメーターを指定します。
-
テレメトリ データをストリーミングするシステム リソースを識別する OpenConfig パス。次に例を示します。
/interfaces/interface/state/counters/ -
データがコレクタ サーバに報告およびストリーミングされる間隔(ミリ秒単位)。例:
sample_frequency = 4000
RPC は telemetrySubscribe 、ストリーミング サーバーまたはコレクターによって、指定されたパスにあるデータのインライン サブスクリプションを要求するために使用されます。その後、デバイスは、サブスクリプション要求と同じ接続でテレメトリ データを送り返す必要があります。
GitHub リソース
GitHub は、バージョン管理とコラボレーションのためのコード ホスティング プラットフォームです。これにより、あなたと他の人がどこからでもプロジェクトで共同作業できます。ジュニパーネットワークスは、テレメトリコードの開発とドキュメントの保存にGitHubを使用するOpenConfigコミュニティの一部です。GitHubでアカウントを作成して、ジュニパーのテレメトリ開発に貢献してください。
| テレメトリリソース |
説明 |
|---|---|
| ジュニパーのテレメトリモデル、補強、偏差。 |
|
| Junos OSリリース別に整理されたジュニパープロトコルバッファファイル。 |
|
| Junos OSリリースで整理されたJuniper gNMIプロトコルバッファファイル。 |
|
| YANGモデル | Junos OS Evolvedリリース23.4R1以降、特定のOSおよびリリースのすべてのYANGデータモデルは、単一のダウンロードパッケージとGitHubリポジトリに保存されます。パッケージとリポジトリには、ネイティブ構成、状態、RPC データ モデルと、その OS でサポートされている OpenConfig とインターネット技術タスク フォース (IETF) データ モデルが含まれています。 |
gRPC を使用してデータをストリーミングする
OpenConfig 仕様では、ストリーミング データに対してサポートされているのは gRPC ベースのトランスポートのみです。ネットワークエージェントパッケージによってインストールされた gRPC サーバーは、クライアントを実行する管理システムからの gRPC セッションを終了します。RPC 呼び出しによって、定期的にデータをストリーミングするかイベントを報告する Junos OS センサーの作成がトリガーされ、ネットワークエージェントによって適切な gRPC チャネルに送られます。
Junos OS リリース 18.2R1 以降、外部のストリーミング サーバーまたはコレクターが、Junos OS を実行するデバイスで gRPC を介してデータをエクスポートするセンサーをプロビジョニングすると、センサーの設定は一時的な構成データベースのインスタンスに junos-analytics コミットされ、操作コマンドを使用して構成を表示できます show ephemeral-configuration instance junos-analytics 。以前のリリースでは、センサー構成は一時的な構成データベースの既定のインスタンスにコミットされます。
アップデートの一部としてエクスポートされていたジュニパーテレメトリヘッダーが、拡張ヘッダーとしてエクスポートされるようになりました。GnmiJuniperTelemetryHeader.proto は、Junos OS リリース 19.3 以前を実行しているジュニパーデバイスからのアップデートをデコードするために使用され、GnmiJuniperTelemetryHeaderExtension.proto は、Junos OS リリース 19.4 以降を実行しているデバイスからの更新をデコードするために使用されます。
Junos テレメトリ インターフェイスをサポートするために実装された RPC の一覧と説明については、 表 2 を参照してください。
RPC 名 |
説明 |
|---|---|
|
テレメトリ パラメーターを指定し、指定した OpenConfig パスのリストのデータをストリーミングします。 |
|
を使用して作成された |
|
で |
gRPC を介してストリーミングされるデータは、プロトコル バッファー (gpb) メッセージで OpenConfig キーと値のペアで書式設定されます。このユニバーサル形式では、キーは、監視対象のデバイスの OpenConfig スキーマ内のシステム リソースのパスに対応する文字列です。値は、インターフェイス カウンターなどのシステム リソースの動作状態とリソースの状態を識別する整数または文字列に対応します。
Junos OS リリース 18.2R1 以降、gRPC を介してストリーミングされるデータは、OpenConfig ベースの RE(ルーティング エンジン)センサーのキーと値のペアに加えて、protobuf としてフォーマットできます。これらのセンサーは、パケット転送エンジン(PFE)センサーに追加されます。
ユニバーサルキー/値の形式を次に示します。
message KeyValue {
string key = 1 [(telemetry_options).is_key = true];
uint64 int_value = 2;
string str_value = 3;
string prefix_str = 4;
}
message TelemetryStream {
// router name or export IP address
required string system_id = 1 [(telemetry_options).is_key = true];
// line card / RE (slot number)
optional uint32 component_id = 2 [(telemetry_options).is_key = true];
// PFE (if applicable)
optional uint32 sub_component_id = 3 [(telemetry_options).is_key = true];
// timestamp (common to all entries in the kv array)
optional uint64 timestamp = 4 [(telemetry_options).is_timestamp = true];
// key / value pairs
repeated KeyValue kv;
}
次の例は、インターフェイスのカウンターのセットがどのように表現されるかを示しています。
key = “/interfaces/counters/rx-bytes”, int_value = 1000 key = “/interfaces/counters/tx-bytes”, int_value = 2000 key = “/interfaces/counters/rx-packets”, int_value = 10 key = “/interfaces/counters/rx-bytes” , int_value = 20 key = “/interfaces/counters/oper-state”, str_value = “up”
ネットワークエージェントパッケージには、フィールド名を OpenConfig キー文字列にマッピングするマッピングテーブルが用意されています。
パケット転送エンジンのトラフィックセンサーデータのエクスポート
Junos OS リリース 17.4R1 以降、MX シリーズおよび PTX シリーズ ルーターの Junos テレメトリ インターフェイスを介してパケット転送エンジンのトラフィック統計をエクスポートできます。UDP と gRPC の両方がサポートされています。
このセンサーは、パケット転送エンジン統計カウンターの報告を追跡し、パケット転送エンジンのエラーとドロップの統計を可視化します。センサー /junos/system/linecard/packet/usage/のリソース名は です。OpenConfig パスは、CPU、NPU、およびセンター チップ (CC) に固有のデータを報告します。次のパスがサポートされています。
/components/component[name='FPCid:NPUid']/properties/property[name='counter']/state/valueここで、FPCはフレキシブルPICコンセントレータを指し、NPUはネットワーク処理ユニット(パケット転送エンジン)を指します。サンプルのリソースパスは、/components/component[name='FPC0:NPU3']/properties/property[name='ts-output-pps']/state/valueのHardware Discards: Data Errorカウンターですhwds-data-error。/components/component[name='FPCid:CCid’]/properties/property[name='counter’]/state/valueここで、FPCはフレキシブルPICコンセントレータを指し、CCはセンターチップを指します。サンプルリソースパスは ここでlpbk-packets、 はFPC0、センターチップ1に固有のカウントForward packetsです/components/component[name='FPC0:CC1']/properties/property[name='lpbk-packets’']/state/value。/components/component[name='FPCid’]/properties/property[name='counter’]/state/valueここで、FPCはフレキシブルPICコンセントレータを指します。サンプルのリソースパスは、/components/component[name='FPC0']/properties/property[name='lts-input-packets’']/state/valuelts-input-packetsはCPUカウンターLocal packets inputです。
gRPC を介してデータをエクスポートするようにセンサーをプロビジョニングするには、RPC を使用して telemetrySubcribe テレメトリ パラメーターを指定します。UDP 経由のストリーミングの場合、すべてのパラメーターは 階層レベルで構成されます [edit services analytics] 。
次に、 コマンドまたは show pfe statistics traffic detail コマンドの出力フィールドshow pfe statistics trafficに対するカウンターのマップを示します(MX シリーズ ルーターでのみサポートされています)。
CPU stats: (FPCX:CPUY)
Packet Forwarding Engine local traffic statistics:
Local packets input : 2
Local packets output : 1
Software input control plane drops : 0
Software input high drops : 0
Software input medium drops : 0
Software input low drops : 0
Software output drops : 0
Hardware input drops : 0
Counter
lts-input-packets Local packets input
lts-output-packets Local packets output
lts-sw-input-control-drops Software input control plane drops
lts-sw-input-high-drops Software input high drops
lts-sw-input-medium-drops Software input medium drops
lts-sw-input-low-drops Software input low drops
lts-sw-output-low-drops Software output drops
NPU stats: (FPCX:CCY)
Input packets: 1169 0 pps
Output packets: 0 0 pps
Fabric Input : 277235149 16078 pps
Fabric Output : 277235149 16079 pps
Counter
ts-input-packets Input packets
ts-input-packets-pps Input packets in pps
ts-output-packets Output packets
ts-output-packets-pps Output packets in pps
ts-fabric-input-packets Fabric Input
ts-fabric-input-packets-pps Fabric Input in pps
ts-fabric-output-packets Fabric Output
ts-fabric-output-packets-pps Fabric Output in pps
Packet Forwarding Engine loopback statistics:
Forward packets : 0 0 pps
Forward bytes : 0 0 bps
Drop packets : 0 0 pps
Drop bytes : 0 0 bps
Counter
lpbk-packets Forward packets
lpbk-packets-pps Forward packets pps
lpbk-packets-byte Forward bytes
lpbk-packets-bps Forward bytes bps
lpbk-drop-packets Drop packets
lpbk-drop-packets Drop packets pps
lpbk-drop-packets Drop bytes
lpbk-drop-packets Drop bytes bps
Lu chips stats: FPCx:NPUY
Counter
lts-hw-input-drops
hwds-normal Hardware discards normal discard
hwds-fabric Hardware discards fabric drops
hwds-info-cell Hardware discards info cell drops
hwds-timeout Hardware discards timeour
hwds-truncated-key Hardware discards truncated key
hwds-bits-to-test Hardware discards bits to test
hwds-stack-underflow Hardware discards stack underflow
hwds-stack-overflow Hardware discards stack overflow
hwds-data-error Hardware discards data error
hwds-extended Hardware discards extended discard
hwds-invalid-iif Hardware discards invalid interface
hwds-input-checksum Hardware discards input checksum
hwds-output-mtu
hwds-inet-bad-route
hwds-inet6-bad-route
hwds-filter-discard
hwds-dlu-not-routable
MXシリーズルーター上のAFTベースのラインカードのテレメトリデータの配信
Junos OS Release 20.4R1 以降、AFT(抽象転送テーブル)をサポートする MPC(モジュラー ポート コンセントレータ)ライン カード(MPC10E や MPC11E ライン カードなど)に、テレメトリのプレフィックスとキー配信の新しい連結が実装されます。OpenConfigパスは、他のラインカードの構文とは異なる方法で分割されます。
以下の出力は、プレフィックスとキー配信の変更を示しています。
Example jtimon output for a port on non-AFT LC key: __prefix__ str_value: /junos/firewall[name='CORERO-MITIGATE-xe-1/0/0.4051-i']/state/ key: counter[name='Corero-Allowed-xe-1/0/0.4051-i']/packets uint_value: 2935220 <<RESULT>> path: /junos/firewall[name='CORERO-MITIGATE-xe-1/0/0.4051-i']/state/counter[name='Corero-Allowed-xe-1/0/0.4051-i']/packets uint_value: 2935220 Example jtimon output for a port on an AFT LC key: __prefix__ str_value: /junos/firewall[name='CORERO-MITIGATE-et-2/0/0.114-i']/state/counter[name='Corero-Allowed-et-2/0/0.114-i']/ key: packets uint_value: 29191907 <<RESULT>> path: /junos/firewall[name='CORERO-MITIGATE-et-2/0/0.114-i']/state/counter[name='Corero-Allowed-et-2/0/0.114-i']/packets uint_value: 29191907
gNMIによる「変更時」センサーサポートの有効化
OpenConfigの動作状態とカウンタの定期的なストリーミングは、Junos OSリリース16.1以降サポートされており、ジュニパー機器から外部コレクタにテレメトリデータをエクスポートしています。必要なすべての情報を収集し、ベースラインの「スナップショット」を作成するのには便利ですが、定期的なストリーミングはタイムクリティカルなミッションにはあまり役立ちません。このような場合、外部コレクターのON_CHANGEストリーミングを設定して、運用状態の状態が変化したときにのみ情報を受信できます。
ON_CHANGE ストリーミングをサポートするために、ネットワーク要素からの設定の変更と取得のために、gRPC ネットワーク管理インターフェイス(gNMI)と呼ばれる新しい仕様が実装されています。さらに、gNMI仕様を使用して、ネットワーク要素からデータ収集システムへのテレメトリストリームを生成および制御できます。新しい gNMI 仕様を使用すると、1 つの gRPC サービス定義で、設定とテレメトリの両方のネットワーク要素に対する単一の実装と、テレメトリと構成 RPC によってデバイスと対話するための 1 つの NMS 要素を提供できます。
Junos ファイル パッケージ(junos-telemetry-interface)には、gNMI サポート用の gnmi.proto ファイルと GnmiJuniperTelemetryHeader.proto Juniper 拡張機能が含まれています。
この機能をサポートするRPCに関する情報は、gNMI Protoファイルバージョン0.4.0(サポートされているバージョン)およびリリースされた仕様にあります
https://github.com/openconfig/reference/blob/primary/rpc/gnmi/gnmi-specification.md
https://github.com/openconfig/gnmi/blob/primary/proto/gnmi/gnmi.proto
gNMI サービスのテレメトリ RPC subscribe は、ON_CHANGE ストリーミングをサポートしています。RPC subscribe を使用すると、クライアントは、データ ツリー内の特定のパスの値を送信するようにターゲットに要求できます。値は、ストリーミング (STREAM)、存続期間の長いチャネルで 1 回限り送信される (POLL)、または取得として 1 回限り送信される (ONCE) ことがあります。
サンプル頻度が 0 の最上位コンテナーに対してサブスクリプションが行われた場合、サポートON_CHANGEリーフはイベントに基づいてストリーミングされます。他の葉はストリーミングされません。
どのノードが ON_CHANGE としてストリーミングされ、どのノードが SAMPLE であるかをデバイスが決定できるようにするには、コレクターが sample_interval を使用して TARGET_DEFINED をサブスクライブする必要があります。
gNMIによる「TARGET_DEFINED」サブスクリプションモードの有効化
Junos OSリリース20.2R1以降、gRPCネットワーク管理インターフェイス(gNMI)サービスによるサブスクリプションモードTARGET_DEFINED、gRPCネットワーク管理インターフェイス(gNMI)サービスによるサブスクリプションモードが、MX5、MX10、MX40、MX80、MX104、MX150、MX204、MX240、MX480、MX960、MX2008、MX2010、MX2020、MX10003、MX10008、およびMX10016の各ルーター上のJTIでサポートされています。
gNMIサブスクリプションを使用して、外部コレクターはセンサーデータの配信方法を規定します。
ストリーミングモードは、指定された間隔でDUTからセンサーデータを定期的にストリーミングします。
ON_CHANGEモードでは、データ値が変更された場合にのみ、DUTからセンサーデータの更新が送信されます。
新たにサポートされるTARGET_DEFINEDモード(サブモード0)は、センサーデータの各要素(リーフ)を外部コレクタに配信する関連モード(ストリーミングまたはON_CHANGE)を選択するようにDUTに指示します。サブモード0のセンサーのサブスクリプションが外部コレクターからDUTに送信されると、DUTが応答し、センサーサブスクリプションがアクティブ化されるため、定期的なストリーミングにはON_CHANGEアップデートが含まれません。ただし、DUT は、該当するON_CHANGEイベントが発生するたびにコレクターに通知します。
サブスクリプションは、サブスクリプション要求でコレクターによって特に指定されていない限り、既定で 30 秒の定期的なストリーミング頻度になります。
以下の Java Script Object Notification (JSON) ファイルは、gNMI サブスクリプションのサンプルを示しています。TARGET_DEFINEDモードは、リソース(センサー)パス /interfaces/interface[name='lo0']/state に対して を使用して設定されますsubmode=0。
$ cat gnmi.json
{
"dut_list":[
{
"port":50051,
"rpc":["sub_request"],
"sub_request":{
"subscription":[
{
"path":"/interfaces/interface[name='lo0']/state",
"submode":0,
"sample_interval":30
}
],
"mode":0,
"encoding":2
}
}
]
$ python ./gnmi_subscribe_client_sample.py -c ./gnmi.json -d 10.53.32.102 -l client.log
Junos ファイル パッケージ(junos-telemetry-interface)には、gNMI サポート用の gnmi.proto ファイルと GnmiJuniperTelemetryHeader.proto Juniper 拡張機能が含まれています。
詳細については、次の gNMI 仕様と gNMI プロトコル ファイルを参照してください。
gNMIによる「INITIAL_SYNC」サブスクリプションモードの有効化
Junos OS Release 20.2R1以降、MX960、MX2008、MX2010、MX2020、PTX1000、PTX5000ルーター、PTX10000ラインルーター、QFX5100およびQFX5200スイッチでgNMIサービスを使用したパケット転送エンジンセンサーからのINITIAL_SYNC統計がサポートされるようになりました。
Junos OS Evolvedリリース20.4R1以降、QFX5130-32CDスイッチでgNMIサービスを使用したパケット転送エンジンセンサーからのINITIAL_SYNC統計がサポートされるようになりました。
外部コレクターが INITIAL_SYNC (gnmi-submode 2) を持つセンサーのサブスクリプション要求を送信すると、ホストは、そのリソースパスの下でサポートされているすべてのターゲットリーフ (フィールド) を、現在の値を持つコレクターに少なくとも 1 回送信します。これは、次の理由で価値があります。
コレクターには、そのセンサーパスのデバイス上のすべてのフィールドの現在の状態の完全なビューがあります。
イベント駆動型データ (ON_CHANGE) は、次のイベントが検出される前に、少なくとも 1 回はコレクターによって受信されます。このようにして、コレクターは次のイベントが発生する前にデータの状態を認識します。
通常はストリーミング データに表示されないゼロカウンタ値(ゼロ抑制)を含むパケット転送エンジン センサーが送信され、各ラインカードのすべてのフィールド(ソースとも呼ばれる)がコレクターに認識されます。
INITIAL_SYNCサブモードでは、少なくとも 1 つのコピーをコレクターに送信する必要があります。ただし、複数送信してもかまいません。
サブスクリプションは、サブスクリプション要求でコレクターによって特に指定されていない限り、既定で 30 秒の定期的なストリーミング頻度になります。
以下の Java Script Object Notification (JSON) ファイルは、gNMI サブスクリプションのサンプルを示しています。INITIAL_SYNCモードは、リソース(センサー)パス /interfaces/ に対して gnmi_submode 2 を使用して設定されます。はgnmi_modeに設定されます0。プロトコルエンコーディングはGBPに対して に設定されます2。
{
"influx": {
"server": "server1",
"port": 8086,
"dbname": "gD40",
"measurement": "OC",
"user": "influx",
"password": "influxdb",
"recreate": true
},
"gnmi": {
"mode": 0, <---- STREAM
"encoding": 2, <--- PROTO encoding
"prefix": "/x/y/z"
},
"host": "10.10.130.73",
"port": 10162,
"user": "user1",
"password": "password1",
"cid": "cid-1jk",
"paths":[
{
"path": "/interfaces/",
"Freq": 10000000000,
"gnmi_submode": 2 <---- SAMPLE
}
]
}
Junos ファイル パッケージ(junos-telemetry-interface)には、gNMI サポート用の gnmi.proto ファイルと GnmiJuniperTelemetryHeader.proto Juniper 拡張機能が含まれています。
詳細については、次の gNMI 仕様と gNMI プロトコル ファイルを参照してください。
gNMI テレメトリ仕様 gNMI プロトコルの定義
https://github.com/openconfig/reference/blob/primary/rpc/gnmi/gnmi-specification.md#35152-stream-subscriptions
https://github.com/openconfig/gnmi/blob/primary/proto/gnmi/gnmi.proto
テレメトリ センサー情報のクライアント ストリーミングと双方向ストリーミングの有効化
Junos OS リリース 18.1R1 以降、リモート プロシージャ コール(gRPC)と JTI による OpenConfig のサポートが拡張され、MX シリーズおよび PTX シリーズ ルーターでのテレメトリ センサー情報のクライアント ストリーミングと双方向ストリーミングがサポートされます。
API は OpenConfig の Protobuf 仕様に基づいて Junos に実装されています。これらのAPIは、トランスポートメカニズムとしてgRPCを使用して、Junosルーター上で設定、運用状態の取得、テレメトリを実行します。
クライアント ストリーミングでは、クライアントは 1 つの要求ではなく、要求のストリームをサーバーに送信します。サーバーは通常、状態の詳細とオプションの末尾メタデータを含む 1 つの応答を返します。双方向ストリーミングでは、クライアントとサーバーの両方が要求と応答のストリームを送信します。クライアントは RPC を呼び出して操作を開始し、サーバーはクライアント メタデータ、メソッド名、および期限を受け取ります。サーバーは、初期メタデータを送り返すか、クライアントが要求の送信を開始するのを待つかを選択できます。クライアントとサーバーは、任意の順序で読み取りと書き込みを行うことができます。ストリームは完全に独立して動作します。
Junosデバイスは、API(RPC)プロトタイプを使用して管理できます。
RPC 機能 (CapabilityRequest)
戻り値 (機能応答)。クライアントが、ターゲットでサポートされている機能のセットを取得できるようにします。
rpc Get (GetRequest)
を返します (GetResponse)。ターゲットからデータのスナップショットを取得します。
rpc Set (SetRequest)
を返します (SetResponse)。クライアントがターゲット上のデータの状態を変更できるようにします。
rpc Subscribe (stream SubscribeRequest)
戻り値 (ストリーム SubscribeResponse)。クライアントが、データ ツリー内の特定のパスの値を送信するようにターゲットに要求できるようにします。これらの値は、ストリーミング (STREAM) するか、存続期間の長いチャネルで 1 回限り送信する (POLL)、または 1 回限りの取得 (ONCE) として送信できます。サンプル頻度が 0 の最上位コンテナーに対してサブスクリプションが行われた場合、サポートON_CHANGEリーフはイベントに基づいてストリーミングされます。他の葉はストリーミングされません。
Juniper Extension Toolkit(JET)のサポートは、JSDに接続されているクライアントのステータスに関するインサイトをユーザーに提供します。gRPC の JET サポートには、JSD に接続できるクライアントの最大数を 8 から 30 に拡張することが含まれます (デフォルトは 5 のままです)。最大接続数を指定するには、[ max-connections ] 階層レベルで ステートメントを記述しますedit system services extension-service request-response grpc。
JSD に接続されているクライアントの状況に関する情報を提供するには、拡張show extension-service client informationコマンドを発行し、 または servers オプションを組み込みclientsます。オプションは、clients要求 - 応答クライアント情報を表示します。オプションは、servers要求 - 応答サーバーの情報を表示します。
SR-TE ポリシー(BGP またはスタティック)のテレメトリ センサー情報のストリーミングの有効化
Junos OSリリース18.3R1以降、gRPCとJTIを介したMXシリーズとPTXシリーズのOpenConfigサポートでは、特定のセグメントルーティングトラフィック制御(SR-TE)ポリシーでアクティブ(BGPまたはスタティック)になっているルートに関係なく、同じセンサーを介して継続的な統計ストリーミングを提供します。
Junos OS Evolvedリリース21.4R1EVOでは、PTX10001-36MR、PTX10004、PTX10008、およびPTX10016ルーターがサポートされています。
この機能は、イングレスルーターでBGP [DRAFT-SRTE]および静的に設定されたSR-TEポリシーをサポートします。
gRPC ストリーミングを介してデータをエクスポートするようにセンサーをプロビジョニングするには、テレメトリ サブスクライブ RPC を使用してテレメトリ パラメーターを指定します。これらの統計情報をエクスポートするリソース パス /mpls/signaling-protocols/segment-routing/ を含めます。
センサーの設定に加えて、Junos OS を介した統計情報の収集も有効にする必要があります。これを行うには、[] 階層レベルに 設定ステートメントを含めstatisticsますedit protocols source-packet-routing telemetry。オプションで、 または no-ingress パラメーターを含めてno-transit統計を制限できます。
センサーの設定手順については 、 Junos で NETCONF プロキシ テレメトリ センサーを設定する を参照してください。
リソースパスの詳細については 、 gRPCおよびgNMIセンサー(Junosテレメトリインターフェイス)のガイドライン を参照してください。
LSP 統計のサポート
LSP 統計センサー / junos/services/label-switched-path/usage/ をプロビジョニングして、MPLS ごとの LSP 統計を監視できます。テレメトリデータはJunosデバイスからストリーミングされ、ポーリングを伴わずにgRPCを介して設定可能な間隔でJTIを介して外部コレクタにエクスポートされます。
Junos OS リリース 15.1F6 でこの機能を最初にサポートしたのは、/ junos/services/label-switched-path/usage/ へのサブスクリプションが行われた場合にのみ、イングレス LSP をサポートしていました。Junos OSリリース17.4R1でこの機能にバイパスサポートが追加されたことで、このサブスクリプションはイングレスLSPとバイパスLSPの両方の統計情報をコレクターにストリーミングするようになりました。
ストリーミングされる統計情報は、 動作モード コマンド show mpls lsp bypass statistics と show mpls lsp ingress statisticsで表示される出力と類似しています。
バイパスLSPの場合、以下がエクスポートされます。
保護された LSP のイングレス ルーターから発信された LSP をバイパスします。
保護された LSP のトランジットルーターから発信された LSP をバイパスします。
トランジット LSP とローカルで発信された LSP を保護する LSP をバイパスします。
バイパスLSPがアクティブな場合、トラフィックはバイパスLSPとイングレス(保護された)LSPの両方でエクスポートされます。
gRPC を介してデータをエクスポートするセンサーをプロビジョニングするには、テレメトリサブスクライブ RPC を使用してテレメトリ パラメーターを指定します。gRPC を介してテレメトリ データをストリーミングするには、OpenConfig for Junos OS モジュールも必要です。OpenConfig パッケージとネットワークエージェントパッケージはどちらも、デフォルトで Junos OS イメージにバンドルされています。
UDP(ネイティブ)センサーの設定については、 Junos テレメトリインターフェイスセンサーの設定(CLI手順) を参照してください。
プラットフォーム別の LSP センサー サポートのレベルについては、 表 3 を参照してください。
プラットフォーム |
イングレスLSP、UDP 導入された機能 |
イングレスLSP、gRPCストリーミング 導入された機能 |
LSP をバイパスする 導入された機能 |
|---|---|---|---|
ACX6360 |
|
|
Junos 19.2R1 トランジットノードから発信されたRSVPバイパスLSP |
MX80/MX104 |
Junos OSリリース15.1F6 Junos OSリリース16.1R3 Junos OSリリース17.2R1 |
|
Junos OSリリース17.4R1 Junos OSリリース17.2X75D50+ |
MPCを搭載したMXシリーズ |
Junos OSリリース15.1F6 |
Junos OSリリース16.1R4 Junos OSリリース17.2R1 |
Junos OSリリース17.4R1 Junos OSリリース17.2X75D50+ |
FPC3によるPTX5000 |
|
Junos OSリリース18.2R1 |
Junos OSリリース17.4R1 |
FPC3によるPTX3000 |
Junos OSリリース15.1F6 Junos OSリリース16.1R3 Junos OSリリース17.2R1 |
Junos OSリリース16.1R4 Junos OSリリース17.2R1 Junos OSリリース18.2R1 |
Junos OSリリース17.4R1 Junos OSリリース17.2X75D50+ |
FPC1/2搭載PTXシリーズ |
Junos OSリリース15.1F6 Junos OSリリース16.1R3 Junos OSリリース17.2R1 |
Junos OSリリース16.1R4 Junos OSリリース17.2R1 Junos OSリリース18.2R1 |
Junos OSリリース17.4R1 Junos OSリリース17.2X75D50+ |
PTX1000 |
Junos OSリリース16.1R3 |
Junos OSリリース16.1R4 Junos OSリリース17.2R1 |
Junos OSリリース17.4R1 Junos OSリリース17.2X75D50+ |
PTX10000 |
Junos OSリリース17.3R1 |
Junos OSリリース17.3R1 |
Junos OSリリース17.4R1 Junos OSリリース17.2X75D50+ |
PTX10001-20C |
|
Junos OSリリース19.1R1 トランジットノードから発信されたRSVPバイパスLSP |
|
PTX10002 |
Junos OSリリース19.1R1 |
Junos OSリリース19.1R1 |
|
Vmx |
Junos OSリリース17.3R1 |
Junos OSリリース17.3R1 |
Junos OSリリース17.4R1 Junos OSリリース17.2X75D50+ |
MX150 |
Junos OSリリース17.4R1 |
Junos OSリリース17.4R1 |
|
EX4600 |
Junos OSリリース18.4R1 |
|
|
EX4650 |
Junos OSリリース18.3R1 |
Junos OSリリース18.3R1 |
|
EX9200 |
Junos OSリリース17.3R1 |
|
|
QFX10000 |
|
|
|
QFX5200 |
Junos OSリリース17.2R1 |
Junos OSリリース17.2R1 |
|
QFX10002 |
Junos OSリリース19.1R1 |
Junos OSリリース19.1R1 |
|
QFX5100 |
Junos OSリリース18.2R1 |
Junos OSリリース18.2R1 |
|
QFX5110 |
Junos OSリリース18.2R1 |
Junos OSリリース18.2R1 |
|
QFX5120-48 |
Junos OSリリース18.3R1 |
Junos OSリリース18.3R1 |
|
QFX5200 |
Junos OSリリース18.2R1 |
Junos OSリリース18.2R1 |
|
ルーティング エンジン センサーのメッセージ終了通知
Junos OS リリース 21.2R1 より、すべての JTI ルーティング エンジン センサーにメッセージ終了(EoM)ブール値フラグが導入されました。このフラグは、特定のセンサー パスの現在のラップが完了したことをコレクターに通知します。ラップは、センサーパスの下にあるすべてのリーフの完全なキー値データダンプです。
また、EoM フラグを使用すると、コレクターは、コレクターがパケットから受信したストリーム作成タイムスタンプ値を比較することなく、ラップの終了が発生したことを検出できます。タイムスタンプ値の比較は、時間的にコストがかかり、データ集約が遅れます。
この機能をgRPCネットワーク管理インターフェイス(gNMI)トランスポートまたはリモートプロシージャコール(gRPC)で使用するには、 ジュニパーネットワークス のダウンロードサイトの関連ブランチからprotobufファイルを取得します。
- GnmiJuniperTelemetryHeaderExtension.proto (gNMI)
- agent.proto(gRPC 用)
たとえば、https://github.com/Juniper/telemetry/blob/master/20.3/20.3R1/protos/GnmiJuniperTelemetryHeaderExtension.proto などです。
コレクタに新しい protobuf ファイルをダウンロードしてインストールすると、受信したパケットに EoM フィールドが存在します。
動的トンネル統計のサポート
Junos OS Release 17.4R1以降、JTIを介してネイティブ(UDP)またはOpenConfigテレメトリセンサーを使用して、パケット転送エンジンの動的トンネルのカウンタ統計を外部コレクタにエクスポートできるようになりました。
この統計情報は、さまざまなネットワーク要素のパフォーマンス メトリックをスケーラブルかつ効率的な方法で報告するために使用され、パケット転送エンジンのエラーとドロップを可視化します。
カウンタが最後にリセットされた日時を示すタイムスタンプは、エクスポートされたすべてのデータに含まれており、コレクターはリセットイベントが発生したかどうか、いつ発生したかを判断できます。たとえば、P acket 転送エンジン ハードウェアが再起動した場合などです。
エクスポートされた統計情報は、 運用モード コマンド show nhdb hw dynamic-ip-tunnelsの出力と類似しています。
gRPC を使用して統計情報のエクスポートをプロビジョニングするには、テレメトリ Subcribe RPC を使用してサブスクリプションを作成し、テレメトリ パラメーターを指定します。サブスクリプションにリソース パス /junos/services/ip-tunnel[name='tunnel-name']/ usage/counters[name='counter-name']/ を含めます 。
gRPC を介してテレメトリ データをストリーミングするには、OpenConfig for Junos OS モジュールも必要です。Junos OS リリース 18.3R1 以降、OpenConfig パッケージとネットワークエージェント パッケージはデフォルトで Junos OS イメージにバンドルされています。どちらのパッケージもJTIをサポートしています。
UDP を介した統計のエクスポートを構成するには、[] 階層レベルのセンサー(Junos Telemetry Interface)構成ステートメントにセンサー/junos/services/ip-tunnel/usage/を含めますedit services analytics。UDP センサーのすべてのパラメーターは、その階層レベルで構成されます。MX80およびMX104ルーターは、UDPストリーミングのみをサポートします。gRPC はサポートされません。
FPCとオプティクスのサポート
Junos OSリリース19.2R1以降、JTIは、リモートプロシージャコール(gRPC)を使用したMXシリーズのFPC(フレキシブルPICコンセントレータ)と光統計のストリーミングをサポートしています。gRPC は、状態情報を構成および取得するためのプロトコルです。サポートには、AFTプラットフォームと呼ばれるOpenConfigモデルのAFTTelementryおよびLibTelemetryライブラリと統合するためにテレメトリデータをエクスポートするための新しいプロセス(SensorDデーモン)の追加が含まれます。
以下の基本リソース・パスがサポートされています。
/junos/システム/ラインカード/環境/
/junos/system/linecard/optics/
gRPC を介してデータをエクスポートするようにセンサーをプロビジョニングするには、テレメトリ Subcribe RPC を使用してテレメトリ パラメーターを指定します。gRPC を介してテレメトリ データをストリーミングするには、OpenConfig for Junos OS モジュールも必要です。Junos OS リリース 18.3R1 以降、OpenConfig パッケージとネットワークエージェント パッケージはデフォルトで Junos OS イメージにバンドルされています。どちらのパッケージもJTIをサポートしています。
MXシリーズでのJunos Fusionに対するJTIブロードバンドエッジ統計サポート
Junos OS リリース 19.2R1 以降、ブロードバンド ネットワーク ゲートウェイ(BNG)および Junos Fusion(加入者が Junos Fusion サテライト デバイスを介して接続される)用に MX ルーターが設定されている場合、加入者ベースのテレメトリ ストリーミングが有効になります。リモート プロシージャー コール(gRPC)を使用して、ブロードバンド エッジ(BBE)テレメトリ統計を外部コレクターにエクスポートできます。
以下を除くすべての BBE リソース パスをストリーミングできます。
/junos/system/subscriber-management/access-network/ancp
/junos/system/subscriber-management/client-protocols/l2tp
/junos/system/subscriber-management/infra/network/l2tp/
BBE統計をストリーミングするには、gRPCサブスクリプションに/ junos/system/subscriber-management/ で始まるリソースパスを含めます。
gRPC を介してデータをエクスポートするようにセンサーをプロビジョニングするには、RPC を使用して telemetrySubscribe テレメトリ パラメーターを指定します。
MPC10E-15C-MRATEラインカードを搭載したMXシリーズルーターのCPUおよびNPUセンサーのサポート
Junos OSリリース19.3R1は、MPC10E-10C-MRATEおよびMPC10E-15C-MRATEラインカードを搭載したMXシリーズルーター上のCPUおよびネットワーク処理ユニット(NPU)センサーをサポートします。JTIでは、gRPCサービスを使用して、これらのセンサーから外部コレクターに統計を設定可能な間隔でエクスポートできます。
以前のJunosリリースでのCPUおよびNPUセンサーへのJunosカーネル実装とは異なり、この機能はOpenConfig AFTモデルを使用します。このため、リソースパスとキーと値のペア(kv)の出力は、Junosカーネルの出力とは異なります。
次のリソースパスを使用して、統計をエクスポートします。
/junos/system/linecard/cpu/memory/
/junos/system/linecard/npu/memory/
/junos/system/linecard/npu/使用率/
gRPC サービスを介してデータをエクスポートするようにセンサーをプロビジョニングするには、RPC を使用して telemetrySubcribe テレメトリ パラメーターを指定します。gRPC を介してテレメトリ データをストリーミングするには、OpenConfig for Junos OS モジュールも必要です。Junos OS リリース 18.3R1 以降、OpenConfig パッケージとネットワークエージェント パッケージはデフォルトで Junos OS イメージにバンドルされています。どちらのパッケージもJTIをサポートしています。
gRPC リソース パスの詳細については、「 gRPC センサーのガイドライン (Junos テレメトリ インターフェイス)」を参照してください。
インターフェースエクスプレスセンサー
インターフェース・エクスプレス・センサーはJTIによってサポートされており、ユーザーが設定可能な速度でインターフェース UP の動作と DOWN ステータスをエクスポートします。このセンサーは、物理インターフェイス センサーの統計情報を活用して、より高速で頻繁な運用ステータス統計を提供します。FPC(フレキシブルPICコンセントレータ)から物理インターフェイスの動作ステータスのみが収集され、報告されます。ルーティング エンジン インターフェイスからの統計情報は報告されません。
センサーを使用して、UDP (ネイティブ) エクスポートまたは gRPC サービスを介して統計をエクスポートできます。
どちらのエクスポート方法でも、次のリソース パスを含めます。
/junos/system/linecard/intf-exp/
Junos OSリリース18.1R1は、PTX1000、PTX3000、PTX5000、およびPTX10000ルーター向けのインターフェイスエクスプレスセンサーをサポートしています。
Junos OSリリース19.3R1は、MX960、MX2010、およびMX2020ルーター用のインターフェイスエクスプレスセンサーをサポートしています。
gRPC リソース パスの詳細については、「 gRPC および gNMI センサーのガイドライン (Junos Telemetry Interface)」を参照してください。
加入者向けのスタンバイルーティングエンジンセンサー
JTI は、gRPC サービスを使用したスタンバイ ルーティング エンジン統計のストリーミングをサポートします。この機能は、特に指示がない限り、単一シャーシとバーチャルシャーシの両方でサポートされています。この機能を使用して、スタンバイ ルーティング エンジンで実行されているソフトウェア コンポーネントの状態をより詳細に追跡できます。以下のセンサー(主に加入者管理下)を介して外部コレクターにエクスポートされた統計情報は、システムの正常性と回復力の状態のより完全なビューを提供します。
シャーシの役割(バックアップまたはプライマリ)センサー /junos/system/subscriber-management/chassis および / junos/system/subscriber-management/ chassis [chassis-index=chassis-index] (MX シリーズ仮想シャーシのインデックスを指定するため)
ルーティングエンジンのステータスとGRES通知センサー /junos/system/subscriber-management/chassis/routing-engine/routing-engineおよび/junos/system/subscriber-management/chassis/routing-engine/routing-engine[re-index=RoutingEngineIndex](特定のルーティングエンジンのインデックス番号を指定する場合)
加入者管理プロセスセンサー /junos/system/subscriber-management/chassis/routing-engine/process-status/subscriber-management-process/subscriber-management-processおよび/junos/system/subscriber-management/chassis/routing-engine/process-status/subscriber-management-processes/subscriber-management-process[pid=ProcessIdentifier](特定のプロセスのPIDを指定する場合)
ルーティングエンジンごと サーバーまたはリレーセンサーのDHCPバインディング統計情報 /junos/system/subscriber-management/chassis/routing-engine/routing-engine/dhcp-bindings/dhcp-element[dhcp-type-name=/v4]および/junos/system/subscriber-management/chassis/routing-engine/routing-engine/dhcp-bindings/dhcp-element[dhcp-type-name=RelayOrServerRelayOrServer/v6]
バーチャルシャーシポートカウンターセンサー /junos/system/subscriber-management/chassis/virtual-chassis-ports/virtual-chassis-port and /junos/system/subscriber-management/chassis/virtual-chassis-ports/virtual-chassis-port[vcp-interface-name=vcp-interface-port-string](インターフェイス名を指定します)。このリソースパスは、バーチャルシャーシでのみサポートされます。
Junos OSリリース20.2R1は、MX480、MX960、MX10003、MX2010、MX2020ルーターのスタンバイルーティングエンジンセンサーをサポートしています。
gRPC および gNMI のリソース パスの詳細については、「 gRPC および gNMI センサーのガイドライン (Junos Telemetry Interface)」を参照してください。
Diameterアプリケーションプロトコルと加入者向けのDiameterピアセンサー
JTIは、Diameterアプリケーションプロトコル、ネットワークアクセスサーバーアプリケーション(NASREQ)、ポリシーおよび課金ルール機能(PCRF)、オンライン課金システム(OCS)の加入者のストリーミング統計をサポートしています。また、新しい直径ピアセンサーも備わっており、直径アプリケーションごとにMXルーターとピアの間で交換されるメッセージの応答時間を測定できます。統計情報は、JTIと、gRPC、gNMI、またはジュニパー独自のRPCまたはUDPを使用したテレメトリのエクスポートをカバーするジュニパーAAAモデルを使用してエクスポートされます。
直径アプリケーションの統計情報をストリーミングするには、リソースパスを含めます。
NASREQ の統計情報については、/ junos/system/subscriber-management/aaa/diameter/clients/nasreq
PCRF 統計については、 / junos/system/subscriber-management/aaa/diameter/clients/gx
OCS 統計については、 / junos/system/subscriber-management/aaa/diameter/clients/gy
直径アプリケーションの応答時間測定値をストリーミングするには、サブスクリプションに、または 構成ステートメントを使用して、リソース・パスを含めます sensor 。
NASREQ測定の場合、 / junos/system/subscriber-management/aaa/diameter/peers/peer[peer_address='peer-address']/nasreq/response-time
PCRF測定の場合、 / junos/system/subscriber-management/aaa/diameter/peers/peer[peer_address='peer-address']/gx/response-time
OCS 測定の場合、 / junos/system/subscriber-management/aaa/diameter/peers/peer[peer_address=''peer-address]/gy/response-time
ネイティブ(UDP)エクスポート用のMXシリーズルーターでこれらの統計を有効にするには、[]階層レベルでステート sensors メントを含めますedit services analytics。
gNMI を介してデータをエクスポートするようにセンサーをプロビジョニングするには、 gnmi.proto で定義されているサブスクライブ RPC を使用して要求パラメーターを指定します。
gRPC を介してデータをエクスポートするようにセンサーをプロビジョニングするには、RPC を使用して telemetrySubscribe テレメトリ パラメーターを指定します。gRPC を介してテレメトリ データをストリーミングするには、OpenConfig for Junos OS モジュールも必要です。Junos OS リリース 18.3R1 以降、OpenConfig パッケージとネットワークエージェント パッケージはデフォルトで Junos OS イメージにバンドルされています。どちらのパッケージもJTIをサポートしています。
Junos OSリリース19.3R1は、MX5、MX10、MX40、MX150、MX204、MX240、MX480、MX960、MX2008、MX2010、MX2020、MX10003、MX10008およびMX100016ルーターの直径アプリケーションプロトコルセンサーをサポートしています。
gRPC および gNMI のリソース パスの詳細については、「 gRPC および gNMI センサーのガイドライン (Junos Telemetry Interface)」を参照してください。
インターフェイス バースト監視
Junos OS Evolvedリリース19.3R1は、Junos Telemetry Interface(JTI)でのインターフェイスバースト監視をサポートし、QFX5220-128CおよびQFX5220-32CDスイッチ上の物理インターフェイスのバーストを監視します。インターフェイス バースト監視は、問題のトラブルシューティング、意思決定、必要に応じてリソースの調整に役立ちます。
サンプリングは、エクスポート間隔 (ウィンドウ) 中にミリ秒の粒度で実行されます。エクスポート間隔は、コレクターからのサブスクリプションを使用してセンサーで構成されます。センサーがインストールされると、パケット転送エンジンでタイマーが開始され、30〜100ミリ秒間隔でハードウェアをポーリングします。最初のエクスポート バッチのレートは 0 になります。
ピーク バイトは、サンプリング間隔で見られるバイト数の平均です。サンプリング間隔より短いバーストの場合、ピーク バイトは間隔にわたって平均化されます。エクスポートされた統計情報には、ピーク バイトが検出された時間や、方向(送信または受信)も含まれます。すべてのサンプルの中でエクスポート間隔中に検出された最大バイト レートは、バーストと見なされます。間隔内に同じバイト数のバーストが複数ある場合、最初に発生したバーストが最大バーストと見なされ、そのバーストのタイムスタンプがバーストタイムスタンプと見なされます。
UP であるすべての物理インターフェイスのデータがエクスポートされます。集約型インターフェイスはサポートされていません。
gRPC(リモート プロシージャ コール)サービスを使用してサブスクリプションにセンサー / junos/system/linecard/bmon-sw/ を含めることで、インターフェイス バーストの統計情報をジュニパー デバイスから外部コレクタにエクスポートできます。このセンサーでサポートされているコレクターは 1 つだけです。
gRPC サービスを介してデータをエクスポートするようにセンサーをプロビジョニングするには、RPC を使用して telemetrySubcribe テレメトリ パラメーターを指定します。gRPC を介してテレメトリ データをストリーミングするには、OpenConfig for Junos OS モジュールも必要です。
この機能はマイクロバーストを検出しません。
トランシーバ診断
Junos OSリリース19.4R1は、MX960、MX2010、MX2020、PTX1000、PTX5000、およびPTX10000ルーターシリーズで、JTIおよびgRPCサービスまたはgNMIサービスを使用して、ON_CHANGEおよびストリーミング統計用の透過診断センサーをサポートしています。トランシーバ診断を使用して、問題のトラブルシューティング、意思決定を行い、必要に応じてリソースを調整します。
この機能は、OpenConfig トランシーバ モデル openconfig-platform-transceiver.yang 0.5.0 をサポートしています。
gRPCまたはgNMIサブスクリプションの基本リソースパス/ components/component/transceiver/を使用して 、ジュニパーデバイスから外部コレクターに統計をエクスポートします。
温度、入力電力、出力電力、レーザー バイアス電流など、連続的に変化するフィールドはON_CHANGEではサポートされません。
物理イーサネット インターフェイス センサー
Junos OSリリース19.4R1は、MX960、MX2020、PTX1000およびPTX5000ルーター上のJTIおよびgRPCサービスまたはgNMIサービスを使用して、ON_CHANGEおよびストリーミング統計の物理イーサネットインターフェイス統計をサポートします。
この機能は、OpenConfig モデル openconfig-if-ethernet.yang (物理インターフェイス レベル)バージョン 2.6.2(設定なし)をサポートします。
gRPCまたはgNMIサブスクリプションの基本リソースパス/ interfaces/interface/ethernet/state/を使用して 、ジュニパーデバイスから外部コレクターに統計情報をエクスポートします。
VLANセンサー
Junos OS リリース 19.4R1 は、EX4650 および QFX5120 スイッチで JTI および gRPC サービスを使用するON_CHANGEのストリーミング VLAN 統計をサポートします。
この機能は、OpenConfig モデル openconfig-vlan.yang 設定バージョン 1.0.2 をサポートします。
gRPCサブスクリプションの基本リソースパス/ vlans/ を使用して、ジュニパーデバイスから外部コレクターに統計をエクスポートします。
サブスクリプションで使用できるその他のエンドポイントは次のとおりです。
/vlans/vlan/state/name
/vlans/vlan/state/vlan-id
/vlans/vlan/members/
/vlans/vlan/members/member/interface-ref/state/interface/
/vlans/vlan/members/member/interface-ref/state/interface/switched-vlan/state/interface-mode
/vlans/vlan/members/member/interface-ref/state/interface/switched-vlan/state/native-vlan
/vlans/vlan/members/member/interface-ref/state/interface/switched-vlan/state/access-vlan
/vlans/vlan/members/member/interface-ref/state/interface/switched-vlan/state/trunk-vlan
/vlans/vlan/members/member/interface-ref/state/interface/vlan/state/vlan-id
変更履歴テーブル
機能のサポートは、使用しているプラットフォームとリリースによって決まります。 機能エクスプローラー を使用して、機能がプラットフォームでサポートされているかどうかを判断します。
junos-analytics コミットされ、操作コマンドを使用して構成を表示できます
show ephemeral-configuration instance junos-analytics 。