テレメトリ ポリシー ファイル
テレメトリ ポリシー ファイルは、生成して受信者にプッシュするテレメトリ データの種類を指定するためにユーザによって定義されます。ポリシーは .policy 拡張子付きのテキスト ファイルに保存する必要があります。複数のポリシー ファイルを定義して、ルータ ファイル システムの /telemetry/policies/ フォルダにインストールできます。
-
1 つ以上の収集グループ。1 つの収集グループには、異なるインターバルでストリーミングされるさまざまなタイプのデータが含まれています。
-
グループごとの秒単位の時間。
-
グループごとの 1 つ以上のパス。
-
ポリシーに関するバージョン、説明、およびその他の詳細情報を含むメタデータ。
ポリシー ファイルの構文
{
"Name": "NameOfPolicy",
"Metadata": {
"Version": 25,
"Description": "This is a sample policy to demonstrate the syntax",
"Comment": "This is the first draft",
"Identifier": "<data that may be sent by the encoder to the mgmt stn"
},
"CollectionGroups": {
"FirstGroup": {
"Period": 10,
"Paths": [
"RootOper.MemorySummary.Node",
"RootOper.RIB.VRF",
"..."
]
},
"SecondGroup": {
"Period": 300,
"Paths": [
"RootOper.Interfaces.Interface"
]
}
}
}
-
Name:ポリシーの名前。以前の例では、ポリシーは
NameOfPolicy.policy
という名前のファイルに保存されます。ポリシーの名前はファイル名と一致する必要があります(.policy 拡張子を除く)。大文字のアルファベット、小文字のアルファベット、および数字を含めることができます。ポリシー名には大文字と小文字の区別があります。 -
Metadata:ポリシーに関する情報。メタデータには、バージョン番号、日付、説明、作成者、著作権情報、その他のポリシーを特定する詳細情報を含めることができます。次のフィールドはポリシーを特定するのに重要です。 -
Description は show policies コマンド内に表示されます。
-
Version および Identifier は、テレメトリ メッセージのメッセージ ヘッダーの一部として受信側に送信されます。
-
-
CollectionGroups:グループ名をそれらに関する情報にマップするエンコーダ オブジェクト。コレクション グループの名前には、大文字のアルファベット、小文字のアルファベット、および数字を含めることができます。グループ名では、大文字と小文字が区別されます。
-
Period:各収集グループのパターン。この期間で、データが照会されてレシーバに送信される頻度を秒単位で指定します。この値は 5 ~ 86400 秒の範囲内に収める必要があります。
-
Paths:データをストリーミングして受信者に送信するための 1 つ以上のスキーマ パス、許可されたリスト エントリまたはネイティブ YANG パス(コンテナ用の)。次に例を示します。
スキーマ パス: RootOper.InfraStatistics.Interface(*).Latest.GenericCounters
YANG パス: /Cisco-IOS-XR-infra-statsd-oper:infra-statistics/interfaces/interface=*/latest/generic-counters
許可されたリスト エントリ "RootOper.Interfaces.Interface(*)": { "IncludeFields": ["State"] }
スキーマ パス
テレメトリ データの収集場所を指定するには、スキーマ パスを使用します。参考のため、いくつかのパスのリストを次のテーブルに示します。
動作 |
パス |
---|---|
インターフェイス運用データ |
RootOper.Interfaces.Interface(*) |
パケット/バイト カウンタ |
RootOper.InfraStatistics.Interface(*).Latest.GenericCounters |
パケット/バイト レート |
RootOper.InfraStatistics.Interface(*).Latest.DataRate |
IPv4 パケット/バイト カウンタ |
RootOper.InfraStatistics.Interface(*).Latest.Protocol(['IPV4_UNICAST']) |
MPLS の統計情報 |
|
QOS の統計情報 |
|
BGP データ |
RootOper.BGP.Instance({'InstanceName': 'default'}).InstanceActive.DefaultVRF.Neighbor([*]) |
インベントリ データ |
RootOper.PlatformInventory.Rack(*).Attributes.BasicInfo RootOper.PlatformInventory.Rack(*).Slot(*).Card(*).Sensor(*).Attributes.BasicInfo |