テレメトリは、自動の通信プロセスです。これにより、測定およびその他のデータがリモート ポイントまたはアクセス不能なポイントで収集され、モニタ用の受信装置に送信されます。モデル駆動型テレメトリは、モデル駆動型テレメトリ対応デバイスから送信先へとデータをストリームするメカニズムを提供します。

テレメトリでは、情報の送信元と送信先を識別するためにサブスクリプション モデルが使用されます。モデル駆動型テレメトリでは、ネットワーク要素の定期的なポーリングが不要になります。その代わりに、ネットワーク要素により、サブスクライバに配信される情報の継続的な要求が確立されます。その後、定期的に、またはオブジェクトの変更のたび、サブスクライブされている YANG オブジェクトのセットが当該のサブスクライバにストリーミングされます。

ストリーミングされるデータは、サブスクリプションによって駆動されます。サブスクリプションにより、アプリケーションは YANG データストアから更新（自動または継続的な更新）をサブスクライブすることができるようになるため、発行者は、それらの更新をプッシュし、実質的にストリーミングすることができます。

サブスクリプションとは、プッシュされるデータのタイプおよび関連する条件を規定する、パブリッシャとサブスクライバとの間の契約です。サブスクリプションにより、クライアントは自動データ更新を含むイベント ストリームをサブスクライブできます。

動的サブスクリプションはサブスクライバとパブリッシャの間で合意されたサブスクリプションであり、<establish-subscription> RPC により確立されます。動的サブスクリプションでは、サブスクライバは RPC 経由でパブリッシャとのサブスクリプション トランザクションを開始します。動的サブスクリプションの有効期間は、それを確立するために使用されるトランスポート セッションによって制約されます。NETCONF の場合、トランスポート セッションがなくなると、関連する動的サブスクリプションは即時に終了します。有効期間は、<delete-subscription> RPC で定義できます。

サブスクリプションで使用されるデータは、ストリームで定義される一連の使用可能なイベントに対して XPath ホワイトリスト フィルタを使用することで指定されます。yang-push は、モデル駆動型テレメトリでサポートされる唯一のストリームです。

次に、<establish-subscription> RPC の例を示します。RPC では、stream、xpath-filter、および period の各フィールドが必須です。

<rpc message-id="101" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
<establish-subscription
xmlns="urn:ietf:params:xml:ns:yang:ietf-event-notifications"
xmlns:yp="urn:ietf:params:xml:ns:yang:ietf-yang-push">
<stream>yp:yang-push</stream>
<yp:xpath-filter>/mdt-oper:mdt-oper-data/mdt-subscriptions</yp:xpath-filter>
<yp:period>1000</yp:period>
</establish-subscription>
</rpc>

テレメトリには <establish-subscription> RPC と <delete-subscription> RPC がサポートされています。

<establish-subscription> RPC が送信されると、パブリッシャからの RPC 応答には <rpc-reply> メッセージと、結果ストリングを含む <subscription-result> 要素が含まれます。

次の表は、<rpc-reply> メッセージでの応答と、応答の理由を示しています。

テレメトリのサブスクリプションおよび更新は、NETCONF セッションを介して転送されます。テレメトリのサブスクリプションを確立するために使用される NETCONF セッションは、テレメトリの更新を受け取ります。NETCONF セッションが破棄されたり、接続が切断された場合は、関連付けられたテレメトリ サブスクリプションも破棄されます。

すべてのセッションが NETCONF セッションであるため、すべてのセッションの制約は、NETCONF の実装に応じたものとなります。

ダイナミック テレメトリの接続は、アクティブなスイッチもしくはスイッチ スタック内のメンバーへの SSH、またはハイ アベイラビリティ対応ルータにおけるアクティブなルート プロセッサへの SSH による NETCONF セッションで確立されます。切り替え後は、テレメトリのサブスクリプションを伝送する NETCONF セッションを含め、暗号を使用するすべてのセッションを破棄し、再確立する必要があります。切り替え後は、すべてのサブスクリプションも再作成する必要があります。

サブスクリプションは、確立された NETCONF セッションを介して、XML RPC を使用して作成されます。<establish-subscription> RPC が IETF テレメトリのクライアントまたはコレクタからネットワーク デバイスに送信されます。RPC では、stream、xpath-filter、および period の各フィールドが必須です。

次に、運用データベースのサブスクリプション テーブルへのサブスクリプションの例を示します。

<rpc message-id="101" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
      <establish-subscription
          xmlns="urn:ietf:params:xml:ns:yang:ietf-event-notifications"
          xmlns:yp="urn:ietf:params:xml:ns:yang:ietf-yang-push">
        <stream>yp:yang-push</stream>
        <yp:xpath-filter>/mdt-oper:mdt-oper-data/mdt-subscriptions</yp:xpath-filter>
        <yp:period>1000</yp:period>
      </establish-subscription>
    </rpc>

サブスクリプションが正常に作成されると、デバイスはサブスクリプション結果 notif-bis:ok およびサブスクリプション ID で応答します。次に、サンプル応答 RPC メッセージの例を示します。

<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="101">
<subscription-result xmlns="urn:ietf:params:xml:ns:yang:ietf-event-notifications" 
xmlns:notif-bis="urn:ietf:params:xml:ns:yang:ietf-event-notifications">notif-bis:
ok</subscription-result>
<subscription-id xmlns="urn:ietf:params:xml:ns:yang:ietf-event-notifications">2147484201</subscription-id>
</rpc-reply>

デバイスからプッシュされるサブスクリプション更新は XML RPC 形式であり、それらが作成された同じ NETCONF セッションにより送信されます。サブスクライブ対象情報の要素またはツリーは datastore-contents-xml タグ内で返されます。次に示すのは、サブスクライブ対象情報を提供するサンプル RPC メッセージです。

<notification xmlns="urn:ietf:params:xml:ns:netconf:notification:1.0">
    <eventTime>2017-05-09T21:34:51.74Z</eventTime>
    <push-update xmlns="urn:ietf:params:xml:ns:yang:ietf-yang-push">
        <subscription-id>2147483650</subscription-id>
        <datastore-contents-xml>
            <cpu-usage xmlns="http://cisco.com/ns/yang/Cisco-IOS-XE-process-cpu-oper"><cpu-utilization>
            <five-minutes>5</five-minutes></cpu-utilization></cpu-usage>
        </datastore-contents-xml>
    </push-update>
</notification>

サブスクリプションが行われる情報要素が空である場合、またはそれが動的（名前付きアクセス リストなど）であり存在しない場合、定期更新は空になり、自己終結 datastore-contents-xml タグを持つことになります。次に示すのは、定期更新が空であるサンプル RPC メッセージです。

<notification xmlns="urn:ietf:params:xml:ns:netconf:notification:1.0">
    <eventTime>2017-05-09T21:34:09.74Z</eventTime>
    <push-update xmlns="urn:ietf:params:xml:ns:yang:ietf-yang-push">
        <subscription-id>2147483649</subscription-id>
        <datastore-contents-xml />
    </push-update>
</notification>

現在のサブスクリプションの一覧を取得するには、<get> RPC を Cisco-IOS-XE-mdt-oper モデルに送信します。現在のサブスクリプションの一覧を表示するには、show telemetry ietf subscription コマンドも使用できます。

次に、<get> RPC メッセージの例を示します。

<rpc message-id="101" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  <get>
    <filter>
      <mdt-oper-data xmlns="http://cisco.com/ns/yang/Cisco-IOS-XE-mdt-oper">
        <mdt-subscriptions/>
      </mdt-oper-data>
    </filter>
  </get>
</rpc>

次に、RPC 応答の例を示します。

<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="101">
  <data>
    <mdt-oper-data xmlns="http://cisco.com/ns/yang/Cisco-IOS-XE-mdt-oper">
      <mdt-subscriptions>
        <subscription-id>2147485164</subscription-id>
        <base>
          <stream>yang-push</stream>
          <encoding>encode-xml</encoding>
          <period>100</period>
          <xpath>/ios:native/router/ios-rip:rip/ios-rip:version</xpath>
        </base>
        <type>sub-type-dynamic</type>
        <state>sub-state-valid</state>
        <comments/>
        <updates-in>0</updates-in>
        <updates-dampened>0</updates-dampened>
        <updates-dropped>0</updates-dropped>
      </mdt-subscriptions>
    </mdt-oper-data>
  </data>
</rpc-reply>

次に、show telemetry ietf subscription dynamic brief コマンドの出力例を示します。

Device# show telemetry ietf subscription dynamic brief 

Telemetry subscription brief

  ID               Type        State       Filter type   
  -----------------------------------------------------
  2147483667       Dynamic     Valid       xpath         
  2147483668       Dynamic     Valid       xpath         
  2147483669       Dynamic     Valid       xpath         

次に、show telemetry ietf subscription subscription-ID detail コマンドの出力例を示します。

Device# show telemetry ietf subscription 2147483667 detail

Telemetry subscription detail:

  Subscription ID: 2147483667
  State: Valid
  Stream: yang-push
  Encoding: encode-xml
  Filter:
    Filter type: xpath
    XPath: /mdt-oper:mdt-oper-data/mdt-subscriptions
  Update policy:
    Update Trigger: periodic
    Period: 1000
  Notes: 

テレメトリ サブスクリプションは、2 つの方法で削除できます。1 つ目は、subscription-id タグにサブスクリプション ID を含む <delete-subscription> RPC を送信することです。これは、サブスクライバのみが実行できます。サブスクリプションは、親 NETCONF セッションが破棄または切断されたときにも削除されます。ネットワーク接続が中断された場合は、SSH/NETCONF セッションがタイムアウトしてその後にサブスクリプションが削除されるまで、多少の時間がかかることがあります。

<rpc message-id="101" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
    <delete-subscription xmlns="urn:ietf:params:xml:ns:yang:ietf-event-notifications" 
    xmlns:netconf="urn:ietf:params:xml:ns:netconf:base:1.0">
        <subscription-id>2147483650</subscription-id>
    </delete-subscription>
</rpc>