Crosswork Data Gateway インスタンスを再展開するには、古いインスタンスを削除して新しいインスタンスをインストールします。新しい Crosswork Data Gateway インスタンスをインストールする方法の詳細については、『Cisco Crosswork Network Controller 5.0 Installation Guide』を参照してください』。

インスタンスの展開プロファイルを変更するために Crosswork Data Gateway インスタンスを再展開する場合（たとえば、プロファイルを Standard から Extended に変更する場合）、Crosswork Data Gateway インスタンスの再展開を試みる前に、Data Gateway グローバル パラメータの変更を手動でロールバックしてください。

考慮すべき重要な点

1. Crosswork Data Gateway インスタンスがすでに Cisco Crosswork に登録されており、同じ名前でインスタンスを再度インストールした場合は、Crosswork Data Gateway インスタンスの [管理状態（Administration State）] を [メンテナンス（Maintenance）] に変更して自動登録を実行します。

2. Crosswork Data Gateway インスタンスがすでに Cisco Crosswork に登録されており、Cisco Crosswork を再度インストールした場合は、既存の Crosswork Data Gateway インスタンスを Cisco Crosswork に再登録します。

   Crosswork Data Gateway の再登録 を参照してください。

データを外部のデータ送信先に転送できる収集ジョブを作成できるようにするには、次のライセンス要件を満たしていることを確認します。

1. メインメニューから、[管理（Administration）] > [アプリケーション管理（Application Management）] > [スマートライセンス（Smart License）] に移動します。

2. アプリケーションフィールドで [Crossworkプラットフォームサービス（Crosswork Platform Services）] を選択します。

3. ステータスが次のようになっていることを確認します。

   • [登録ステータス（Registration Status ）]：[登録済み（Registered）]

     Cisco Smart Software Manager（CSSM）に登録済みであり、予約済みライセンス機能の使用が許可されていることを示します。

   • [ライセンス認証ステータス（License Authorization Status）]：[認証済み（Authorized）]（[準拠（In Compliance）]）

     外部収集ジョブのデバイス数を超えていないことを示します。

   • [スマートライセンスの使用状況（Smart Licensing Usage）] で、CW_EXTERNAL_COLLECT のステータスが [準拠（In Compliance）] になっています。

評価期間が終了した後、または外部収集ジョブのデバイス数を超えた場合（[ライセンス認証ステータス（License Authorization Status）] が [コンプライアンス違反（Out of Compliance）]）、Cisco Smart Software Manager（CSSM）に登録しないと、外部収集ジョブを作成できません。ただし、この場合も既存の収集ジョブは表示および削除できます。

Cisco Crosswork Data Gateway は、ネットワークデバイスからの CLI ベースのデータ収集をサポートしています。このタイプの収集ジョブでは、次のコマンドがサポートされています。

• show と、短縮バージョンの sh

• traceroute

• dir

CLI 収集を適切に動作させるためには、デバイスにバナー設定を含めないでください。これをオフにする方法については、デバイスのマニュアルを参照してください。

CLI 収集ジョブは、Cisco Crosswork の UI からか、または API を使用して作成できます。詳細については、Cisco DevNet を参照してください。

次に、Kafka 外部接続先の CLI 収集ジョブのペイロードの例を示します。この例では、特に 2 つの値に注意してください。

1. デバイスは、IP アドレスではなく UUID で識別されます。

2. 宛先も UUID によって参照されます。UI を使用して作成された収集ジョブの場合、Cisco Crosswork は UUID を検索します。独自の収集ジョブを作成するときは、これらの値を調べる必要があります。

{
  "collection_job": {
    "application_context": {
      "context_id": "collection-job1",
      "application_id": "APP1"
    },
    "collection_mode": {
      "lifetime_type": "APPLICATION_MANAGED",
      "collector_type": "CLI_COLLECTOR"
    },
    "job_device_set": {
      "device_set": {
        "devices": {
          "device_ids": [
            "658adb03-cc61-448d-972f-4fcec32cbfe8"
          ]
        }
      }
    },
    "sensor_input_configs": [
      {
        "sensor_data": {
          "cli_sensor": {
            "command": "show platform"
          }
        },
        "cadence_in_millisec": "tel:60000"
      }
    ],
    "sensor_output_configs": [
     {
        "sensor_data": {
          "cli_sensor": {
            "command": "show platform"
          }
        },
        "destination": {
          "destination_id": "1e71f2fb-ea65-4242-8efa-e33cec71b369",
          "context_id": "topic1"
        }
      }
    ]
  }
}

Cisco Crosswork Data Gateway では、デバイスでサポートされている OID に基づく SNMP ベースのデータ収集をサポートしています。

SNMP コレクタは、設定プロファイル（収集する MIB オブジェクトのリストと取得先のデバイスのリスト）を取得するためのポーリング要求を Cisco Crosswork に行います。事前にパッケージ化された MIB モジュールのリストまたは MIB モジュールのカスタムリストを検索して、対応する OID を決定します。

（注）	Cisco Crosswork Data Gateway は、システムにすでに含まれている標準的な MIB のサードパーティ製デバイスで SNMP ポーリングを有効にします。独自の MIB は、収集要求が独自の MIB から MIB テーブル名またはスカラー名を参照する場合にのみ必要です。ただし、要求が OID ベースの場合、MIB は必要ありません。

OID が解決されると、SNMP コレクタへの入力として提供されます。

セクションカスタムパッケージの追加の説明に従って、Crosswork Data Gateway インスタンスにデバイスパッケージをインポートできます。

データポーリングとトラップでサポートされている SNMP バージョンは次のとおりです。

• ポーリングデータ

  • SNMP V2

  • SNMP V3（no auth nopriv、auth no priv、authpriv）

  • サポートされている認証プロトコル：SHA-1、MD5

  • サポートされている priv プロトコル：AES-128、AES-192、AES-256、CiscoAES192、CiscoAES256、DES、および 3-DES。

• トラップ

  • SNMP V2

  • SNMP V3（no auth nopriv、auth no priv、authpriv）

デバイスでの設定例：

次の表に、さまざまな SNMP 機能を有効にするサンプルコマンドを示します。詳細については、プラットフォーム固有のドキュメントを参照してください。

SNMP コレクタは、次の操作をサポートしています。

• スカラー

  （注）	1 つの収集で複数のスカラー OID を要求する場合は、デバイスへの 1 つの getbulkrequestquery で複数の SNMP GET 要求をパックできます。

• TABLE

• WALK

• COLUMN

これらの操作は、センサー設定で定義されます（以下のペイロード例を参照）。

（注）	デバイスの応答時間が 1,500 ミ リ秒を超える場合は、オプションの deviceParams 属性 snmpRequestTimeoutMillis （ペイロード例には表示されていない）を使用する必要があります。デバイスの応答時間が長いことが確実でない限り、snmpRequestTimeoutMillis を使用することは推奨されません。 snmpRequestTimeoutMillis の値はミリ秒単位で指定する必要があります。 デフォルトの最小値は 1,500 ミリ秒です。ただし、この属性の最大値に制限はありません。

次に、SNMP 収集ジョブの例を示します。

{
  "collection_job": {
    "application_context": {
      "context_id": "collection-job1",
      "application_id": "APP1"
    },
    "collection_mode": {
      "lifetime_type": "APPLICATION_MANAGED",
      "collector_type": "SNMP_COLLECTOR"
    },
    "job_device_set": {
      "device_set": {
        "devices": {
          "device_ids": [
            "c70fc034-0cbd-443f-ad3d-a30d4319f937",
            "8627c130-9127-4ed7-ace5-93d3b4321d5e",
            "c0067069-c8f6-4183-9e67-1f2e9bf56f58"
          ]
        }
      }
    },
    "sensor_input_configs": [
      {
        "sensor_data": {
          "snmp_sensor": {
            "snmp_mib": {
              "oid": "1.3.6.1.2.1.1.3.0",
              "snmp_operation": "SCALAR"
            }
          }
        },
        "cadence_in_millisec": "60000"
      },
      {
        "sensor_data": {
          "snmp_sensor": {
            "snmp_mib": {
              "oid": "1.3.6.1.2.1.31.1.1",
              "snmp_operation": "TABLE"
            }
          }
        },
        "cadence_in_millisec": "60000"
      }
    ],
    "sensor_output_configs": [
      {
        "sensor_data": {
          "snmp_sensor": {
            "snmp_mib": {
              "oid": "1.3.6.1.2.1.1.3.0",
              "snmp_operation": "SCALAR"
            }
          }
        },
        "destination": {
          "destination_id": "4c2ab662-2670-4b3c-b7d3-b94acba98c56",
          "context_id": "topic1_461cb8aa-a16a-44b8-b79f-c3daf3ea925f"
        }
      },
      {
        "sensor_data": {
          "snmp_sensor": {
            "snmp_mib": {
              "oid": "1.3.6.1.2.1.31.1.1",
              "snmp_operation": "TABLE"
            }
          }
        },
        "destination": {
          "destination_id": "4c2ab662-2670-4b3c-b7d3-b94acba98c56",
          "context_id": "topic2_e7ed6300-fc8c-47ee-8445-70e543057f8a"
        }
      }
    ]
  }
}

SNMP トラップ収集ジョブ

SNMP トラップ収集ジョブは、API を介してのみ作成できます。トラップリスナーはポートでリッスンし、（関心のあるトピックに基づいて）受信者にデータをディスパッチします。

重要	SNMP トラップ収集を開始する前に、Common EMS Services アプリケーションをインストールし、SNMP のホスト情報を構成します。

Crosswork Data Gateway は、UDP ポート 1062 でトラップをリッスンします。

（注）	SNMP トラップ収集ジョブを送信する前に、SNMP トラップをデバイス上で正しく設定して、Crosswork Data Gateway の仮想 IP アドレスに送信する必要があります。

SNMP トラップ収集ジョブのワークフロー

SNMP トラップを受信すると、Cisco Crosswork Data Gateway は以下を実行します。

1. デバイスに対して収集ジョブが作成されているかどうかを確認します。

2. トラップバージョンとコミュニティ文字列を確認します。

   （注）	Crosswork Data Gateway が SNMP トラップのコミュニティ文字列をチェックしないようにするには、Crosswork UI を介してデバイスを追加するときに、[SNMPトラップ無効化チェック（SNMP Disable Trap Check）] チェックボックスをオンにします。このオプションの詳細については、UI を使用したデバイスの追加を参照してください。

3. SNMP v3 の場合は、ユーザー認証と priv プロトコルとクレデンシャルも検証します。

   （注）	SNMPV3 auth-priv トラップは、デバイスまたはルータの engineId に依存して、ローカル USM ユーザーテーブルを維持します。したがって、デバイスまたはルータの engineId が変更されるたびに、トラップの受信が中断されます。トラップの受信を再開するには、それぞれのデバイスを取り外して取り付けてください。

Crosswork Data Gateway は、センサーパスに示されたトラップ OID に基づいてトラップをフィルタ処理し、要求されたトラップのみを送信します。

収集ジョブが無効か、デバイスに設定がないか、またはトラップが受信されない場合、ジョブのステータスは [不明（Unknown）] のままです。サポートされているトラップと MIB のリストについては、「SNMP での収集用に事前にロードしたトラップと MIB のリスト」を参照してください。

Crosswork Data Gateway は、次の 3 つのタイプの非 YANG/OID ベースのトラップをサポートします。

表 4. サポートされている非 YANG/OID ベースのトラップのリスト

センサーパス	目的
*	フィルタなしでデバイスからプッシュされたすべてのトラップを取得します。
MIB レベルトラップ	1 つの MIB 通知の OID （例：すべての isis-mib レベルトラップを取得する場合は 1.3.6.1.2.1.138.0）
特定のトラップ	特定のトラップの OID （例：linkUp トラップを取得する場合は 1.3.6.1.6.3.1.1.5.4）

次に、SNMP トラップ収集ジョブの例を示します。

{
  "collection_job": {
    "application_context": {
      "context_id": "collection-job1",
      "application_id": "APP1"
    },
    "collection_mode": {
      "lifetime_type": "APPLICATION_MANAGED",
      "collector_type": "TRAP_COLLECTOR"
    },
    "job_device_set": {
      "device_set": {
        "devices": {
          "device_ids": [
            "a9b8f43d-130b-4866-a26a-4d0f9e07562a",
            "8c4431a0-f21d-452d-95a8-84323a19e0d6",
            "eaab2647-2351-40ae-bf94-6e4a3d79af3a"
          ]
        }
      }
    },
    "sensor_input_configs": [
      {
        "sensor_data": {
          "trap_sensor": {
            "path": "1.3.6.1.6.3.1.1.4"
          }
        },
        "cadence_in_millisec": "60000"
      }
    ],
    "sensor_output_configs": [
      {
        "sensor_data": {
          "trap_sensor": {
            "path": "1.3.6.1.6.3.1.1.4"
          }
        },
        "destination": {
          "destination_id": "4c2ab662-2670-4b3c-b7d3-b94acba98c56",
          "context_id": "topic1_696600ae-80ee-4a02-96cb-3a01a2415324"
        }
      }
    ]
  }
}

{
  "nodeIdStr": "BF5-XRV9K1.tr3.es",
  "nodeIdUuid": "C9tZ5lJoSJKf5OZ67+U5JQ==",
  "collectionId": "133",
  "collectionStartTime": "1580931985267",
  "msgTimestamp": "1580931985267",
  "dataGpbkv": [
    {
      "timestamp": "1580931985267",
      "name": "trapsensor.path",
      "snmpTrap": {
        "version": "V2c",
        "pduType": "TRAP",
        "v2v3Data": {
          "agentAddress": "172.70.39.227",
          "oidRecords": [
            {
              "oid": "1.3.6.1.2.1.1.3.0",
              "strValue": "7 days, 2:15:17.02"
            },
            {
              "oid": "1.3.6.1.6.3.1.1.4.1.0",  // This oid is the Object Identifier.
              "strValue": "1.3.6.1.6.3.1.1.5.3" // This is the value that determines the kind of trap.
            },
            {
              "oid": "1.3.6.1.2.1.2.2.1.1.8",
              "strValue": "8"
            },
            {
              "oid": "1.3.6.1.2.1.2.2.1.2.8",
              "strValue": "GigabitEthernet0/0/0/2"
            },
            {
              "oid": "1.3.6.1.2.1.2.2.1.3.8",
              "strValue": "6"
            },
            {
              "oid": "1.3.6.1.4.1.9.9.276.1.1.2.1.3.8",
              "strValue": "down"
            }
          ]
        }
      }
    }
  ],
  "collectionEndTime": "1580931985267",
  "collectorUuid": "YmNjZjEzMTktZjFlOS00NTE5LWI4OTgtY2Y1ZmQxZDFjNWExOlRSQVBfQ09MTEVDVE9S",
  "status": {
    "status": "SUCCESS"
  },
  "modelData": {},
  "sensorData": {
    "trapSensor": {
      "path": "1.3.6.1.6.3.1.1.5.4"
    }
  },
  "applicationContexts": [
    {
      "applicationId": "APP1",
      "contextId": "collection-job-snmp-traps"
    }
  ]
}

Crosswork Data Gateway は、モデル駆動型テレメトリ（MDT）を使用してネットワークデバイスからのデータ収集をサポートし、デバイスからのテレメトリストリームを直接消費します（IOS-XR ベースのプラットフォームのみ）。

Crosswork Data Gateway は、次のトランスポートモードのデータ収集をサポートしています。

• MDT TCP ダイヤルアウトモード

Cisco Crosswork は NSO を利用して必要な MDT 設定をデバイスにプッシュし、対応する収集ジョブの設定を Crosswork Data Gateway に送信します。

（注）	バックアップ操作と復元操作の間に既存の MDT ジョブに何らかの変更（更新）がある場合、Cisco Crosswork はデバイス上で設定更新のジョブを再生しません。これには NSO が関係するためです。NSO/デバイスの設定を復元する必要があります。Cisco Crosswork はデータベース内のジョブのみを復元します。 YANG モジュールを使用する前に、サポートされているかどうかを確認します。「MDT での収集用に事前にロードした YANG モジュールのリスト」の項を参照してください。

次に、MDT 収集のペイロードの例を示します。

{
	"collection_job": {
		"job_device_set": {
			"device_set": {
				"device_group": "mdt"
			}
		},
		"sensor_output_configs": [{
				"sensor_data": {
					"mdt_sensor": {
						"path": "Cisco-IOS-XR-infra-statsd-oper:infra-statistics/interfaces/interface/latest/generic-counters"
					}
				},
				"destination": {
					"context_id": "cw.mdt_sensor.cisco-ios-xr-infra-statsd-oper.gpb",
					"destination_id": "c2a8fba8-8363-3d22-b0c2-a9e449693fae"
				}
			},
			{
				"sensor_data": {
					"mdt_sensor": {
						"path": "Cisco-IOS-XR-infra-statsd-oper:infra-statistics/interfaces/interface/data-rate"
					}
				},
				"destination": {
					"context_id": "cw.mdt_sensor.cisco-ios-xr-infra-statsd-oper.gpb",
					"destination_id": "c2a8fba8-8363-3d22-b0c2-a9e449693fae"
				}
			}
		],
		"sensor_input_configs": [{
				"sensor_data": {
					"mdt_sensor": {
						"path": "Cisco-IOS-XR-infra-statsd-oper:infra-statistics/interfaces/interface/data-rate"
					}
				},
				"cadence_in_millisec": "70000"
			}, {
				"sensor_data": {
					"mdt_sensor": {
						"path": "Cisco-IOS-XR-infra-statsd-oper:infra-statistics/interfaces/interface/latest/generic-counters"
					}
				},
				"cadence_in_millisec": "70000"
			}
		],
		"application_context": {
			"context_id": "c4",
			"application_id": "a4-mdt"
		},
		"collection_mode": {
			"lifetime_type": "APPLICATION_MANAGED",
			"collector_type": "MDT_COLLECTOR"
		}
	}
}

MDT 収集ジョブのワークフロー

MDT ベースの KPI がデバイスでアクティブ化されると、Cisco Crosswork

1. 構成要求を NSO に送信して、ターゲットデバイスでのデータ収集を有効にします。

2. Crosswork Data Gateway に収集ジョブ作成リクエストを送信します。

3. Crosswork Data Gateway は、収集したデータを指定した宛先に送信するためのディストリビューションを作成します。

Crosswork Data Gateway は、デバイスからの Syslog ベースのイベント収集をサポートしています。

重要	Syslog トラップ収集を開始する前に、Common EMS Services アプリケーションをインストールし、Syslog のホスト情報を構成します。

サポートされている Syslog 形式は、次のとおりです。

• RFC5424 syslog 形式

• RFC3164 syslog 形式

（注）

ネットワーク内の Crosswork Data Gateway から Syslog データを収集するには、デバイスを追加するときに YANG_CLI 機能を選択し、Crosswork Data Gateway から Syslog データを受信するように他のパラメータを設定します。プラットフォーム固有のマニュアルを参照してください。 構成手順の順序は重要ではありませんが、両方の手順を完了する必要があります。そうしないと、データが送信または収集されません。デバイスの設定例については、「デバイスでの Syslog（非セキュア）の設定」を参照してください。Cisco Crosswork では、デバイスへのセキュアな Syslog 通信を設定することもできます。詳細については、デバイスでのセキュア Syslog の設定を参照してください。

{
  "collection_job": {
      "job_device_set": {
      "device_set": {
        "devices": {
          "device_ids": [
            "c6f25a33-92e6-468a-ba0d-15490f1ce787"
          ]
        }
      }
    },
    "sensor_output_configs": [
      {
        "sensor_data": {
          "syslog_sensor": {
            "pris": {
                "facilities": [0, 1, 3, 23,4],
                "severities": [0, 4, 5, 6, 7]
            }
        }
        },
        "destination": {
          "context_id": "syslogtopic",
          "destination_id": "c2a8fba8-8363-3d22-b0c2-a9e449693fae"
        }
      }
    ],
    "sensor_input_configs": [
      {
        "sensor_data": {
          "syslog_sensor": {
            "pris": {
                "facilities": [0,1, 3, 23,4],
                "severities": [0,4, 5, 6, 7]
            }
        }
        },
        "cadence_in_millisec": "60000"
      }
    ],
    "application_context": {
      "context_id": "demomilesstone2syslog",
      "application_id": "SyslogDemo2"
    },
    "collection_mode": {
      "lifetime_type": "APPLICATION_MANAGED",
      "collector_type": "SYSLOG_COLLECTOR"
    }
  }
}

• Syslog データ収集の出力は、PRI ベースの SyslogSensor またはフィルタベースの SyslogSensor を指定することでフィルタ処理することができます。ペイロードに記載されている機能と重大度に一致する Syslog イベントが、指定された宛先に送信されます。一致しない他のすべての Syslog イベントはドロップされます。正規表現、重大度、または機能に基づいてフィルタを指定できます。

• 重大度と機能の値を指定した場合、両方の条件は、フィルタレベルで指定された論理演算子に基づいて結合されます。

• 論理演算子 AND または OR を使用して、最大 3 つのフィルタの組み合わせを指定できます。デフォルトでは、演算子を指定しない場合、AND 演算子が適用されます。

Cisco Crosswork は、Cisco Crosswork Data Gateway を介した gRPC ネットワーク管理インターフェイス（gNMI）ベースのテレメトリデータの収集をサポートしています。サブスクリプションに基づく gNMI ダイヤルイン（gRPC ダイヤルイン）ストリーミングのテレメトリデータと、要求した接続先への後続のサブスクリプション応答（通知）のリレーのみをサポートします。

（注）	モデルがターゲットのデバイスプラットフォームでサポートされている限り、gNMI 収集はサポートされます。 gNMI 収集ジョブを送信するには、デバイスで gNMI を設定しておく必要があります。プラットフォーム固有のマニュアルを確認します。

デバイスで gNMI を設定するには、「デバイスで gNMI を有効にします。」を参照してください。

gNMI では、セキュアモードと非セキュアモードの両方をデバイスで共存させることができます。Cisco Crosswork は、インベントリで渡された情報に基づいて、非セキュアモードよりもセキュアモードを優先します。

デバイスがリロードされると、gNMI コレクタは既存のサブスクリプションがデバイスに再サブスクライブされるようにします。

gNMI 仕様には、メッセージの終わりをマークする方法がありません。したがって、接続先とディスパッチのパターンは gNMI コレクタではサポートされません。

Cisco Crosswork Data Gateway は、gNMI の次のタイプのサブスクライブオプションをサポートしています。

Crosswork Data Gateway は、デバイスへの単一のサブスクリプションリストで複数のサブスクリプションパスをサブスクライブする機能をサポートしています。たとえば、ON_CHANGE とサブスクリプションモードの ONCE 収集ジョブの組み合わせを指定できます。ON_CHANGE モードは、指定したパスの特定の要素の変更時にのみデータを収集します。一方、サブスクリプションモードの ONCE は、指定したパスの現在のシステムデータを 1 回だけ収集して送信します。

（注）

Crosswork Data Gateway は、1 つ以上のモードのサポートの宣言をデバイスに依存します。 デフォルト値の gNMI センサーパスはペイロードに表示されません。これは既知の protobuf の動作です。 boolean の場合、デフォルト値は false です。enum の場合は、gnmi.proto が指定されます。 例 1： message GNMIDeviceSetting { bool suppress_redundant = 1; bool allow_aggregation = 4; bool updates_only = 6; } 例 2： enum SubscriptionMode { TARGET_DEFINED = 0; //default value will not be printed ON_CHANGE = 1; SAMPLE = 2; }

{
    "collection_job": {
        "job_device_set": {
            "device_set": {
                "device_group": "milpitas"
            }
        },
        "sensor_output_configs": [{
            "sensor_data": {
                "gnmi_standard_sensor": {
                    "Subscribe_request": {
                        "subscribe": {
                            "subscription": [{
                                "path": {
                                    "origin": "openconfig-interfaces",
                                    "elem": [{
                                        "name": "interfaces/interface/state/ifindex"
                                    }]
                                },
                                "mode": "SAMPLE",
                                "sample_interval": 10000000000
                            }, {
                                "path": {
                                    "origin": "openconfig-interfaces",
                                    "elem": [{
                                        "name": "interfaces/interfaces/state/counters/out-octets"
                                    }]
                                },
                                "mode": "ON_CHANGE",
                                "sample_interval": 10000000000
                            }],
                            "mode": "STREAM",
                            "encoding": "JSON"
                        }
                    }
                }
            },
            "destination": {
                "context_id": "hukarz",
                "destination_id": "c2a8fba8-8363-3d22-b0c2-a9e449693fae"
            }
        }],
        "sensor_input_configs": [{
            "sensor_data": {
                "gnmi_standard_sensor": {
                    "Subscribe_request": {
                        "subscribe": {
                            "subscription": [{
                                "path": {
                                    "origin": "openconfig-interfaces",
                                    "elem": [{
                                        "name": "interfaces/interface/state/ifindex"
                                    }]
                                },
                                "mode": "SAMPLE",
                                "sample_interval": 10000000000
                            }, {
                                "path": {
                                    "origin": "openconfig-interfaces",
                                    "elem": [{
                                        "name": "interfaces/interfaces/state/counters/out-octets"
                                    }]
                                },
                                "mode": "ON_CHANGE",
                                "sample_interval": 10000000000
                            }],
                            "mode": "STREAM",
                            "encoding": "JSON"
                        }
                    }
                }
            },
            "cadence_in_millisec": "60000"
        }],
        "application_context": {
            "context_id": "testing.group.gnmi.subscription.onchange",
            "application_id": "testing.postman.gnmi.standard.persistent"
        },
        "collection_mode": {
            "lifetime_type": "APPLICATION_MANAGED",
            "collector_type": "GNMI_COLLECTOR"
        }
    }
}

Crosswork Data Gateway は、ネットワークデバイスからのネットワーク設定プロトコル（NETCONF）ベースのデータ収集をサポートしています。

（注）	NETCONF データ収集のサポートは、CNC 5.0 リリース以降では廃止されています。

NETCONF 収集の場合、Crosswork Data Gateway は、CLI 収集ジョブ用にロードされる次のデバイスパッケージを利用します。

• システムデバイスパッケージ：Crosswork Data Gateway の起動後にダウンロードされるシステムデバイスパッケージ。

• カスタムデバイスパッケージ：UI または API からアップロードされたカスタムデバイスパッケージ。

NETCONF コレクタは、次の 2 つのタイプのデータ収集をサポートしています。

• プルベースの収集

  パターンベースの収集とオンデマンド収集をサポートします。

  （注）	NETCONF コマンドベースの収集はサポートされていません。

• イベントベースの収集

  https://tools.ietf.org/html/rfc5277 のドキュメントに記載されている NETCONF イベント通知をサポートしています。オンデマンド収集はこのタイプの収集ではサポートされておらず、これらの収集ジョブに指定されたパターンは無視されます。

NETCONF 収集ジョブのワークフロー

1. NETCONF 収集ジョブが収集サービス（Helios/Magellan）に送信され要求された収集のパターンまたは数、あるいはイベント通知 RPC を指定します。

2. 収集サービス（Helios / Magellan）は、収集ジョブを Crosswork Data Gateway の NETCONF コレクタに送信します。

3. 収集のタイプ（イベントベースの収集かプルベースの収集か）に応じて、NETCONF コレクタはデバイスから収集を開始します。

4. 収集されたデータは、指定されたデータ送信先（gRPC/Kafka）に転送されます。

{
  "createUpdateJob": {
    "jobId": {
      "deviceId": "6fa90381-95f3-4a95-ac32-37754e002225",
      "sensorPath": {
        "netconfSensor": {
          "devicePackage": {
            "devicePackageName": "optical_inventory_svo_mne",
            "functionName": "getRawNodeInfo"
          }
        }
      },
      "collectionType": "PERSISTENT_COLLECTION_TYPE"
    },
    "collectionType": "PERSISTENT_COLLECTION_TYPE",
    "deviceId": "6fa90381-95f3-4a95-ac32-37754e002225",
    "sensorConfig": {
      "sensorPath": {
        "netconfSensor": {
          "devicePackage": {
            "devicePackageName": "optical_inventory_svo_mne",
            "functionName": "getRawNodeInfo"
          }
        }
      },
      "cadenceInMillisec": "60000"
    },
    "destinationSensorConfigs": [
      {
        "jobDestinationId": {
          "destinationId": "6dbc2a4c-e827-438f-9bab-bbeb508c06e2",
          "destinationContextId": "NativeNetconfTopic"
        },
        "destinationId": "6dbc2a4c-e827-438f-9bab-bbeb508c06e2",
        "destinationContextId": "NativeNetconfTopic",
        "sensorConfigHandler": {
          "action": "NORMAL"
        },
        "applicationContext": [
          {
            "applicationId": "EPNM-APP",
            "contextId": "Native-Netconf"
          }
        ]
      }
    ]
  }
}