gNMI を使用したテレメトリ データのサブスクライブ

gNMI プロトコルは、テレメトリ データをサブスクライブするための RPC Subscribe を定義します。テレメトリ コレクターは、この RPC を使用して、状態と構成データの更新をネットワーク デバイスに要求します。

新しいサブスクリプションの要求は、1 つ以上のリソース パスを含む SubscribeRequest メッセージ内にカプセル化されます。サブスクライブされたパスは、ターゲットネットワークデバイス上の特定のデータインスタンスに関連しています。要求には、OpenConfigまたはネイティブJunosスキーマに基づいたパスを含めることができます。

サブスクリプション要求には、次のいずれかのモードも含める必要があります。

• ONCE - データの 1 回限りの要求。

• POLL - データの定期的なオンデマンド検索用。

• STREAM - 指定されたトリガーに従ってデータをストリーミングする有効期間の長いサブスクリプション。

STREAM モードのサブスクリプションでは、次のいずれかのサブモードを指定する必要があります。

• ON_CHANGE - データの更新は、データ項目の値が変更されたときにのみ送信されます。

• SAMPLE - データの更新は、サブスクリプション要求で指定された間隔期間に基づいて、サンプル間隔ごとに 1 回送信されます。デフォルトのサンプル間隔は 30 秒です。

• TARGET_DEFINED - サブスクリプション要求を受信するネットワークデバイスは、リーフごとにデータの最適な配信タイプを決定します。メッセージ内に指定されたパスがイベント ドリブン データを参照している場合は、 ON_CHANGE サブスクリプションが作成される可能性があります。カウンター値を表すデータの場合、 SAMPLE サブスクリプションが作成されることがあります。

  手記：

  構成パスに対する TARGET_DEFINED サブスクリプション要求は、 ON_CHANGE 要求としてのみ扱われます。

ONCE、ON_CHANGE、およびSAMPLEサブスクリプションの場合、コレクターは、サブスクリプション内のパスの現在の状態を含む初期更新を要求できます。この更新は初期同期とも呼ばれ、次の理由で役立ちます。

• コレクターには、そのセンサーパスのデバイス上のすべてのフィールドの現在の状態の完全なビューがあります。

• イベント駆動型データ (ON_CHANGE) は、次のイベントが検出される前に、少なくとも 1 回はコレクターによって受信されます。このようにして、コレクターは次のイベントが発生する前にデータの状態を認識します。

• パケット転送エンジン センサーは、通常はゼロ抑制のためにストリーミング データに表示されないゼロ カウンター値を含むセンサーが送信されます。これにより、各ラインカードのすべてのフィールドがコレクターに認識されます。

ターゲットデバイスは、サブスクリプション要求に SubscribeResponse メッセージで応答します。サブスクリプション要求で初期同期が呼び出された場合、ターゲットはデータを送信し、その後に sync_response フラグが true に設定された応答メッセージを送信します。初期同期の後、ターゲットデバイスはサブスクリプションモードに従ってパスの更新を続行します。

SubscribeRequestメッセージには、updates_only というフラグが含まれています。このフラグを true に設定すると、ターゲット デバイスは初期同期を送信せず、次のような後続の更新のみを送信します。

• SAMPLE モードでサブスクリプションをSTREAMする場合、更新は次のサンプル間隔で送信されます。

• ON_CHANGE モードのSTREAMサブスクリプションの場合、次回の値が変更されたときに更新が送信されます。

• ONCEサブスクリプションの場合、sync_response が false に設定された状態でSubscribeResponseのみが送信され、サブスクリプションは閉じられます。

• TARGET_DEFINED サブスクリプションは構成パスの ON_CHANGE として扱われ、次の値の変更時に更新が送信されます。

SubscribeRequest メッセージとSubscribeResponseメッセージの内容は、gnmi.proto ファイルで定義されます。サブスクライブ RPC およびサブスクリプション モードの詳細については、「gNMI 仕様: テレメトリ更新プログラムのサブスクライブ」の gNMI 仕様を参照してください。

手記：

構成パスには、次の制限が適用されます。

• POLL サブスクリプションはサポートされていません。

• プレフィックス パスは、更新メッセージに含まれません。

• gNMI 応答は、 active/inactive、 insert before/after、 comment/annotate、 protect/unprotect などのジュニパー固有のメタデータ操作ではサポートされていません。これらはメッセージに表示されることがありますが、無効です。

• SubscribeRequestでサポートされていないパラメーターには、suppress_redundant、heartbeat_level、allow_aggregation、および qos があります。

• PROTO エンコーディングのみがサポートされています。

• SubscribeRequestメッセージの拡張子はサポートされていません

• サブスクリプション パスのフィルター処理は、キー レベルでのみサポートされます。

• 以下のコミットバリアントは、 ON_CHANGE および TARGET_DEFINED サブスクリプションではサポートされていません。

  commit at、commit prepare/activate、バッチ コミット。

• からのコミットはサポートされていません。

  edit dynamicおよびedit private編集モードまたは構成モード。

• プレゼンス コンテナの更新メッセージは送信されません。

• 識別子またはキーが構成されている唯一のリーフであるサブスクリプション リストの場合、更新メッセージが表示されない場合があります。