SAN アナリティクスの設定

この章では、SAN アナリティクス機能とその設定方法について説明します。

SAN アナリティクスの設定の機能履歴

表 1. SAN アナリティクスの設定の機能履歴
機能名	リリース	機能情報
クエリ構文	8.3(2)	昇順または降順でのメトリックおよびメタデータフィールドのソートのサポートが追加されています。 asc オプションと desc オプションがクエリ構文に追加されました。 select all \| `column1`[, `column2`, `column3`, …] from `analytics_type.view_type` [ where `filter_list1` [ and `filter_list2` …]] [ sort `column` [asc \| desc ] ] [ limit `number`]
SAN アナリティクス	8.3(1)	次のコマンドが導入されました。 no analytics name `query_name` Cisco MDS NX-OS リリース 8.2(1) から Cisco MDS NX-OS リリース 8.3(1) の間に変更されたコマンドについては、表 1を参照してください。
ポートサンプリング	8.3(1)	ポートサンプリング機能を使用すると、監視対象モジュール内のポートのサブセットからデータを収集し、ポートの複数のサブセットを循環し、定期的なポートサンプリング間隔でそれらのポートからのデータをストリーミングできます。次のコマンドが導入されました。 analytics port-sampling module `number` size `number` interval `seconds` show analytics port-sampling module `number`
SAN アナリティクス	8.3(1)	次の新しいフローメトリックが導入されました。 read_io_scsi_busy_count read_io_scsi_check_condition_count read_io_scsi_queue_full_count read_io_scsi_reservation_conflict_count sampling_end_time sampling_start_time total_time_metric_based_read_io_bytes total_time_metric_based_read_io_count total_time_metric_based_write_io_bytes total_time_metric_based_write_io_count write_io_scsi_busy_count write_io_scsi_check_condition_count write_io_scsi_queue_full_count write_io_scsi_reservation_conflict_count 詳細については、「フローメトリック」を参照してください。
Cisco MDS 9132T 32-Gbps 32-Port Fibre Channel Switch の SAN アナリティクスのサポート	8.3(1)	Cisco MDS 9132T 32-Gbps 32-Port Fibre Channel Switch がサポートされているハードウェアの一覧に追加されました。
SAN アナリティクス	8.2(1)	Cisco MDS 9700 48-Port 32-Gbps Fibre Channel Switching Module がサポートされているハードウェアの一覧に追加されました。
Cisco NPV スイッチの SAN アナリティクスのサポート	8.3(1)	Cisco NPV スイッチで SAN アナリティクス機能を使用する際の注意事項と制約事項が追加されました。
SAN アナリティクス	8.2(1)	SAN アナリティクス機能を使用すると、Cisco MDS 9000 シリーズマルチレイヤスイッチにおけるパフォーマンスの問題を監視、分析、特定、およびトラブルシューティングできます。次に、追加されたコマンドを示します。 analytics type fc-scsi analytics query `“query_string”` type timer `timer_val` clear analytics `“query_string”` feature analytics purge analytics `“query_string”` ShowAnalytics show analytics {query {`“query_string”` \| `id` result } \| type fc-scsi flow congestion-drops [ vsan `number`] [ module `number` port `number`]}

SAN アナリティクスの概要

SAN アナリティクス機能を使用すると、Cisco MDS スイッチにおけるパフォーマンスの問題を監視、分析、特定、およびトラブルシューティングできます。サポートされているスイッチの一覧については、SAN アナリティクスのハードウェア要件を参照してください。

ファイバチャネル SAN 環境では、すべてのデバイスのパフォーマンスをプロビジョニングおよび監視して、それらのデバイスのパフォーマンスの妨げになる問題を解決可能にすることが重要です。SAN アナリティクス機能は、フローを双方向で監視し、モジュールまたは個々のスイッチ内でネットワークプロセッサユニット（NPU）のフローを関連付けて、完全に分析されたネットワークデータをユーザに提供します。

次の図は、SAN アナリティクス機能の各機能を示しています。

SAN アナリティクスのハードウェア要件

次の表は、SAN アナリティクス機能をサポートする Cisco MDS ハードウェアの一覧です。

表 2. サポートされているハードウェアの一覧
スイッチ	モジュール
Cisco MDS 9700 シリーズマルチレイヤディレクタ	Cisco MDS 9700 48-Port 32-Gbps Fibre Channel Switching Module（DS-X9648-1536K9）
Cisco MDS 9132T 32-Gbps 32-Port Fibre Channel Switch	32 Gbps 固定ポート X 16 16-Port 32-Gbps Fibre Channel Expansion Module（M9XT-FC1632）

SAN アナリティクスの注意事項と制約事項

次のような場合、この機能は VSAN ではサポートされません。
- default zone permit が設定されている場合。
- VSAN 間ルーティング（IVR）または Cisco MDS 9000 Input/Output Accelerator（IOA）機能が有効になっている場合。
- 相互運用性モードが有効になってい場合。
この機能には、クエリに関する次の制約事項があります。
- プッシュクエリの最大数は 8 です。プッシュクエリの詳細については、SAN アナリティクスについてを参照してください。
- 個々のメトリックのクリアや消去はサポートされていません。メトリックのクリアおよび消去の詳細については、SAN アナリティクスについてを参照してください。
- クエリ構文の where 条件には、等号（=）演算子のみ使用できます。詳細については、「クエリ構文」を参照してください。
この機能を DCNM（またはサードパーティ製のデバイスやアプリケーション）とともに使用する場合は、Network Time Protocol（NTP）を同期させる必要があります。NTP の詳細については、Cisco MDS 9000 シリーズ基本コンフィギュレーションガイド [英語] の「Configuring NTP」セクションを参照してください。
この機能は、Switched Port Analyzer（SPAN; スイッチドポートアナライザ）宛先（SD）ポートおよび NP ポートではサポートされていません。この機能をあるインターフェイスの範囲で有効にする場合は、そのインターフェイスの範囲に SD ポートや NP ポートが存在しないことを確認してください。存在する場合、この機能はいずれのインターフェイスでも有効になりません。
この機能は、現在行われている Fibre Channel Protocol（FCP）SCSI 読み取りまたは書き込みフレームの交換だけを分析します。Fibre Channel Non-Volatile Memory Express（FC-NVMe）トラフィックおよび Fibre Connection（FICON）のサポートは、今後のリリースで追加されます。
feature analytics コマンドが Cisco MDS NX-OS リリース 8.2(1) またはリリース 8.3(1) で有効になっている場合、Cisco MDS NX-OS リリース 8.2(1) とリリース 8.3(1) 間でのアップグレードやダウングレードは、アップグレードやダウングレードの前に no feature analytics コマンドを使用してこの機能を無効にし、その後 feature analytics コマンドを使用してこの機能を有効にした場合にのみサポートされます。

Cisco MDS NX-OS リリース 8.3(1) 以降のリリースからリリース 8.2(1) にダウングレードした場合、この機能は、バグ CSCvm19337 に記載されている回避策を実行した後にのみ機能します。
アップグレード、ダウングレード、スイッチのリロード、またはモジュールのリロード後は、すべてのフローメトリックが消去されます。
ストリーミングサンプル間隔（snsr-grp id sample-interval interval ）、ポートサンプリング間隔（analytics port-sampling module number size number interval seconds ）、およびプッシュクエリ間隔（analytics query “query_string” name query_name type periodic [ interval seconds] [clear ] [differential ] ）は、同じ値に設定することをお勧めします。また、最初にプッシュクエリ間隔、次にポートサンプリング間隔、最後にストリーミングサンプル間隔を変更または設定することをお勧めします。
ストリーミングサンプル間隔、ポートサンプリング間隔、およびプッシュクエリ間隔は、最小推奨値の 30 秒以上に設定することをお勧めします。最小値未満の間隔を設定すると、望ましくないシステム動作が発生する可能性があります。
モジュールごとのサポートされる Initiator-Target-LUN（ITL）の最大数については、Cisco MDS NX-OS の設定の制限、リリース 8.x [英語] を参照してください。

アクティブな ITL 数が記載されている制限を超えると、Syslog メッセージが記録されます。制限を長時間超えている場合、スイッチの安定性に影響が出る可能性があります。show analytics system-load コマンドを使用して、ITL 数と NPU の負荷を確認します。詳細については、Cisco MDS 9000 ファミリおよび Nexus 7000 シリーズ NX-OS システムメッセージリファレンスガイド [英語] および Cisco MDS NX-OS の設定の制限、リリース 8.x [英語] を参照してください。
ネットワークプロセッサユニット（NPU）のキャパシティの超過および超過に伴う結果を回避するためには、ポートサンプリング機能を使用してフローメトリックを分析します。詳細については、ポートサンプリングを参照してください。
ビューインスタンスとその関連メトリックを消去後は、数秒待機してから、プルクエリを実行することをお勧めします。これは、消去操作が完了するまでは、フローメトリックの一部のフィールドに無関係な値が含まれていることがあるためです。
この機能は、ポート単位ですべてのフローメトリックを追跡します。フローの要求と応答が 1 台のスイッチの異なる物理ポートにまたがっている場合、一部のフローメトリックが正確に計算されない可能性があります。この状況は特に、Inter-Switch Link（ISL）ポート（E ポート）でこの機能が有効になっている場合に発生します。

以下に、要求の応答を異なる ISL ポートで確認できるシナリオを示します。
- ユーザが vsan ID loadbalancing src-dst-id コマンドを使用して、ロードバランシング方式を Source ID（SID）-Destination ID（DID）に変更している場合。
- ユーザが switchport trunk mode off コマンドを使用して、ISL（E ポート）を非トランキングモードに設定している場合。
- ポートチャネルの一部である ISL（E ポート）とポートチャネルが no channel mode active コマンドを使用してアクティブモードに設定されていない場合。
- この機能は、非トランク ISL またはポートチャネルでは機能しません。この機能を E ポートで機能させるには、E ポートのトランクモードをオンにする必要があります。
- ISL がポートチャネルの一部になるようにバンドルされていない場合。
- Cisco MDS 9250i マルチサービスファブリックスイッチまたは Cisco MDS 9148S 16-G マルチレイヤファブリックスイッチ、および CiscoMDS 9700 48-Port 32-Gbps Fibre Channel Switching Module（DS-X9648-1536K9）間にポートチャネルが存在する場合。

コマンドの変更点

Cisco MDS NX-OS リリース 8.2(1) と比較した場合、Cisco MDS NX-OS リリース 8.3(1) では一部のコマンドが変更されています。このマニュアルでは、Cisco MDS NX-OS リリース 8.3(1) で導入または変更されたコマンドを使用しています。Cisco MDS NX-OS リリース 8.2(1) で使用されている同等のコマンドについては、表 1を参照してください。

SAN アナリティクス機能を使用する場合の推奨リリースは、Cisco MDS NX-OS リリース 8.3(1) です。

表 1 には、Cisco MDS NX-OS リリース 8.2(1) と Cisco MDS NX-OS リリース 8.3(1) 間のコマンドの変更点が示されています。

表 3. コマンドの変更
Cisco MDS NX-OS リリース 8.3(1)	Cisco MDS NX-OS リリース 8.2(1)
analytics query `“query_string”` name `query_name` type periodic [interval `seconds`] [clear ] [differential ]	analytics query `“query_string”` type timer `timer_val`
clear analytics query `“query_string”`	clear analytics `“query_string”`
purge analytics query `“query_string”`	purge analytics `“query_string”`
show analytics query {`“query_string”` [clear ] [differential ] \| all \| name `query_name` result }	show analytics query {`“query_string”` \| `id` result }

SAN アナリティクスについて

SAN アナリティクス機能は、データ分析のために特定のフレームを使用してフローメトリックを収集します。対象には次のコンポーネントが含まれます。

データ収集：フローデータは NPU から収集され、最終的にスイッチのスーパーバイザに送信されて保存されます。表示されるデータはデータのリアルタイムビューで、履歴データは表示されません。
オンボードクエリ：プルクエリ、プッシュクエリ、またはオーバーレイ CLI を使用して、データベースに保存されているデータを抽出できます。クエリは、データベースから特定のフローメトリックを抽出するために使用されます。特定のフレームは、スイッチのパフォーマンスの問題を監視、分析、およびトラブルシューティングするために使用されます。詳細については、「クエリの作成と使用」を参照してください。

以下は、データベースのさまざまなクエリ方法です。
- プルクエリ：クエリの実行時にデータベースに保存されているフロー情報を抽出するために使用されるワンタイムクエリ。出力は JSON 形式です。プルクエリは NX-API に準拠しています。
  
  オーバーレイ CLI：フローメトリックが使いやすい表形式で表示される定義済みのプルクエリ。これは Python で記述されている CLI ラッパーで、実行に備えてブートフラッシュに保存されています。
- Cisco MDS NX-OS リリース 8.3(1) 以降は、次のオプションがプルクエリでサポートされています。
  - [クリア（Clear）]：ストリーミングサンプル間隔後にすべての最小、最大、およびピークフローのメトリックをクリアします。
  - [差分（Differential）]：ストリーミングサンプル間隔の間に変更された ITL フローメトリックのみストリーミングします。スケール値を向上させるために、差分プッシュクエリを使用することをお勧めします。
- プッシュクエリ：データベースに保存されているフローメトリックを定期的に抽出し、宛先に送信するためにインストールされている繰り返しクエリ。出力は JSON 形式です。
  
  Cisco MDS NX-OS リリース 8.3(1) 以降は、次のオプションがプッシュクエリでサポートされています。
  - [クリア（Clear）]：ストリーミングサンプル間隔後にすべての最小、最大、およびピークフローのメトリックをクリアします。
  - [差分（Differential）]：ストリーミングサンプル間隔の間に変更された ITL フローメトリックのみストリーミングします。スケール値を向上させるために、差分プッシュクエリを使用することをお勧めします。
  プッシュクエリでは、次のフローメトリックの抽出モードがサポートされています。
  - 連続モード：データは、すべての分析対応ポートで継続的に収集されます。
  - サンプリングモード：データは、設定されているポートサンプリング間隔ごとに分析対応ポートのサブセットで収集され、その後、データ収集メカニズムが次のポートのサブセットを循環します。たとえば、データは、30 秒のポートサンプリング間隔で、24 の分析対応ポート内の 6 ポートのグループで収集されます。詳細については、ポートサンプリングを参照してください。

フローメトリックの保存に使用されるデータベースは、次の階層に従って編成されます。

分析タイプ：分析のタイプを指定します。Cisco MDS NX-OS リリース 8.2(1) と Cisco MDS NX-OS リリース 8.3(1) では、fc-scsi タイプのみサポートされています。
ビュータイプ：メトリックデータベースのビュータイプを指定します。ビューは、フローを構成するコンポーネント（ポートビュー、initiator_IT ビュー、target_ITL ビューなど）に基づいて定義されます。クエリ構文は、あるビュータイプでクエリを実行するために使用されます。構文は、1 つのビュータイプで 1 つのクエリのみサポートします。サポートされているビュータイプの一覧については、サポートされているビュータイプの一覧を参照してください。
ビューインスタンス：特定のビュータイプのインスタンスを指定します。ビューインスタンスには独自のフローメトリックがあります。たとえば、ポートビュータイプの場合、fc1/1 が 1 つのインスタンスで、fc1/2 が別のインスタンスのようになります。
フローメトリック：分析に使用されるフローメトリックを指定します。サポートされているフローメトリックの一覧については、ポートビューインスタンスを参照してください。

次の図は、サンプルデータベースのさまざまなコンポーネントを示しています。

クエリ構文の設定例については、例：クエリ構文の設定を参照してください。

次に、フローデータの収集ワークフローを示します。

機能の有効化：フローメトリックを分析する必要があるスイッチの SAN アナリティクス機能を有効にします。
インターフェイスの有効化：インターフェイスでのフローメトリックの収集を有効にします。ホストインターフェイスの SAN アナリティクス機能を有効にすることをお勧めします（展開モードの図を参照）。

クエリの実行とインストール：データベースからフローメトリックを取得するために、次のクエリが使用されます。

プルクエリ：スイッチの問題を直接トラブルシューティングするために、ほぼリアルタイムのフローメトリックを提供します。プルクエリからのデータは、クエリに応答したときにデータベースから抽出されます。プルクエリは、CLI または NX-API を使用して実行できます。DCNM は NX-API を使用して、可視化用のデータを収集できます。

オーバーレイ CLI：フローメトリックが使いやすい表形式で表示される定義済みのプルクエリ。スイッチの問題を直接トラブルシューティングするために、ほぼリアルタイムのフローメトリックを提供します。

次の図は、プルクエリの機能を示しています。

図 3. プルクエリ

プッシュクエリ：フローメトリックを定期的に提供します。時間間隔は秒単位で指定できます。指定された時間間隔を過ぎると、ユーザに関する特定のフローメトリックが更新されて、データベースからプッシュされます。複数のクエリがインストールされている場合、各プッシュクエリがお互いに無関係にフローメトリックをプッシュします。これは想定されている動作です。

（注）

プルクエリ、プッシュクエリ、およびオーバーレイ CLI は、SAN アナリティクス機能が有効になっているインターフェイスでのみ適用されます。
プッシュクエリタイマーは NPU からフローメトリックを取得し、指定されたプッシュクエリ間隔でスーパーバイザ上のデータベースに保存します。

次の図は、一定のメトリックだけが特定の間隔で更新されるように設定されているプッシュクエリの機能を示しています。

メトリックのクリアとリセット：次の機能を使用すると、データベース内の収集したフローメトリックをクリアまたはリセットできます。

消去：指定されたビューインスタンス、およびそのビューインスタンスと関連付けられているすべてのメトリックを削除します。

次の図は、消去メトリッククエリの機能を示しています。

図 5. 消去メトリッククエリ

クリア：clear analytics query “query_string” コマンドで指定されているクエリ構文を満たすメトリックをすべてリセットします。

（注）

ビューは、ポート、イニシエータ、ターゲット、LUN、またはこれらの有効な組み合せに関するフローメトリックを表すものです。クリアは、ビューインスタンスのすべてのフローメトリックをリセットします。消去は、特定のビューインスタンスとその関連フローメトリックを一瞬で削除します。データベースをクリアまたは消去しても、データベースは指定された “query_string” のフローメトリックの収集を続けます。
clear analytics query コマンドは、プッシュクエリで使用されている clear オプションとは異なります。clear analytics query コマンドは、クエリ構文を満たすすべてのメトリックをリセットします。プッシュクエリで使用される clear オプションは、最小、最大、およびピークフローメトリックをリセットするだけです。

次の図は、クリアメトリッククエリの機能を示しています。

ポートサンプリング

Cisco MDS NX-OS リリース 8.3(1) で導入されたポートサンプリング機能を使用すると、監視対象モジュール内のポートのサブセットからデータを収集し、ポートのさまざまｎサブセットを循環し、定期的なポートサンプリング間隔でそれらのポートからのデータをストリーミングできます。

この機能は、NPU の負荷が高く、モジュール上の監視対象ポートの数を削減できまない場合に特に便利です。そのような状況では、指定されたポートサンプリング間隔で監視対象ポートのサブセットをサンプリングすることで NPU の負荷を削減できます。show analytics system-load コマンドを使用して、NPU の負荷を確認します。

Cisco MDS NX-OS リリース 8.3(2) からは、NPU の負荷が高い場合、ITL 数がモジュールの制限を超えている場合、ITL 数がシステムの制限を超えている場合、NPU から分析データに関する応答がない場合にアラートを表示するシステムメッセージが導入されています。詳細については、Cisco MDS 9000 ファミリおよび Nexus 7000 シリーズ NX-OS システムメッセージリファレンス [英語] を参照してください。

サンプリングされていない監視対象ポートで発生する IO およびエラーは表示されず、分析データには含まれません。

この機能で使用されているポートサンプリング間隔は、ストリーミングサンプル間隔とは無関係です。ストリーミングサンプル間隔、ポートサンプリング間隔、およびプッシュクエリ間隔は、最小推奨値の 30 秒以上に設定することをお勧めします。

（注）

モジュールでポートサンプリング機能が有効になっていて、後にそのモジュールの新しいポートで SAN アナリティクス機能が有効になった場合、新しいポートのポートサンプリングデータは次のポートサンプリング間隔後に初めてストリーミングされます。

ポートサンプリングのシナリオ

48 ポートで構成されているモジュールを、2 つの 24 ポートのサブセットにグループ化するとします。それらのポートのサブセットに設定されているポートサンプリング間隔および設定されているストリーミングサンプル間隔に応じて、フローメトリックは異なる間隔でキャプチャされます（次の例を参照）。

ポートサンプリング間隔とストリーミングサンプル間隔が同時刻に始まる場合。

図 8. 同時刻に始まるポートサンプリング間隔とストリーミングサンプル間隔
ポートサンプリング間隔とストリーミングサンプル間隔が異なる時刻に始まる場合。

図 9. 異なる時刻に始まるポートサンプリング間隔とストリーミングサンプル間隔

展開モード

SAN アナリティクス機能をサポートしているスイッチが SAN ファブリックで展開されている場所に応じて、次の展開モードが考えられます。

ホストエッジ展開モード

SAN アナリティクス機能は、すべての Cisco MDS コアスイッチ、およびホストに接続されているインターフェイスで有効になっています。

（注）

展開モードは、次の優先順位で使用することをお勧めします。

ホストエッジ展開モード
ストレージエッジ展開モード
ISL 展開モード

サードパーティ製のデバイスがネットワークに接続されている場合は、ベンダーのマニュアルで推奨の展開モードを確認してください。

ストレージエッジ展開モード

SAN アナリティクス機能は、すべての Cisco MDS コアスイッチ、およびストレージアレイに接続されているインターフェイスで有効になっています。

ISL 展開モード

SAN アナリティクス機能は、すべての Cisco MDS コアスイッチ、および ISL のいずれかのサイドにあるインターフェイスで有効になっています。

次の図は、サポート対象モジュールとサポート対象外モジュール（16 Gbps ファイバチャネル、Cisco MDS 9700 40-Gbps 24-Port FCoE Module（DS-X9824-960K9）、Cisco MDS 24/10-Port SAN Extension Module（DS-X9334-K9）など）が SAN で使用されている場合の SAN アナリティクス機能の各機能を示してします。

（注）

サポート対象モジュールとサポート対象外モジュールが使用されている場合の SAN アナリティクス機能の機能の番号 1 と 2 は、それぞれイニシエータからターゲットに向かう 2 つの異なるフローを表しています。

図 13. サポート対象モジュールとサポート対象外モジュールが使用されている場合の SAN アナリティクス機能の各機能

（注）

前述の ISL モードのシナリオでは、要求の応答はポートチャネルの異なるメンバーで確認できます。
ISL でサポート対象モジュールとサポート対象外モジュールが使用されている場合、その ISL で分析された分析データは正確ではない可能性があります。そのため、サポート対象モジュールとサポート対象外モジュールが使用されている ISL ではデータを分析しないことをお勧めします。

オンボードクエリ

クエリを実行後、フローメトリックが収集されてスーパーバイザデータベースに保存され、スイッチ上に表示されます。

メトリックのクエリ用のスキーマ

スキーマは、データベースに保存されている特定のデータをユーザに表示するために使用されます。メトリックは、さまざまなビューインスタンスの形式でデータベース内に保持されています。それらのビューインスタンスは、クエリを使用して取得できます。詳細については、ビューを参照してください。

クエリ構文

プッシュクエリ、プルクエリ、メトリックのクリア、ビューの消去で使用されるクエリ構文を次に示します。

select all | column1[, column2, column3, …] from analytics_type.view_type [ where filter_list1 [ and filter_list2 …]] [ sort column [asc | desc ]] [ limit number]

クエリ構文の要素は次のとおりです。

analytics_type ：分析のタイプを指定します。Cisco MDS NX-OS リリース 8.2(1) および Cisco MDS NX-OS リリース 8.3(1) では、fc-scsi タイプのみサポートされています。
view_type ：メトリックデータベースのビュータイプを指定します。この構文はそのビュータイプでクエリを実行するために使用されます。構文は、1 つのビュータイプで 1 つのクエリのみサポートします。サポートされているビュータイプの一覧については、サポートされているビュータイプの一覧を参照してください。
column ：フローメトリックを指定します。ビューインスタンスには複数の列が含まれています。
filter_list ：ビューインスタンスの特定のメトリックを抽出するフィルタを指定します。フィルタ条件は、タイプが key 値のフローメトリック列、またはビューインスタンス列で使用できます。フィルタリングに AND 演算子を使用することもできます。サポートされているビュータイプの一覧については、サポートされているビュータイプの一覧を参照してください。
sort ：列内の結果をソートすることを指定します。ソートは limit 操作の実行前に行われます。
asc ：列内の結果を昇順にソートすることを指定します。デフォルトでは、順序が指定されていない場合ソートは昇順で行われます。
desc ：列内の結果を降順にソートすることを指定します。
limit ：結果に返されるメトリック数を制限することを指定します。

クエリ構文の設定例については、「クエリ構文の設定」を参照してください。

（注）

"query_string" の limit および where オプションは、key フィールドでのみ使用できます。key フィールドの詳細については、フローメトリックを参照してください。
Cisco MDS NX-OS リリース 8.3(2) より前は、"query_string" の sort オプションは key フィールドでのみ使用でき、メトリックは昇順でのみソートされていました。Cisco MDS NX-OS リリース 8.3(2) からは、"query_string" の sort オプションは、すべての metrics および metadata フィールドで使用でき、asc または desc オプションをそれぞれ使用して、昇順または降順でソートできます。デフォルトでは、順序が指定されていない場合ソートは昇順で行われます。key フィールドの詳細については、フローメトリックを参照してください。

sort asc または sort desc オプションを指定してプッシュクエリを設定している場合は、Cisco MDS NX-OS リリース 8.3(2) から Cisco MDS NX-OS リリース 8.3(1) または以前のリリースにダウングレードする前に、それらの sort オプションを削除してください。

クエリセマンティックルール

以下は、クエリセマンティックの作成に関するルールです。

select 、 from 、 where 、 sort 、および limit 条件は、クエリ構文の説明に従い、同じ順序で使用する必要があります。
select 条件の下にある列の一覧は、from 条件の下にある view_type に対応するスキーマに属している必要があります。
where 条件は、タイプが key 値のフローメトリックフィールドでのみ使用できます。タイプが key 値のフローメトリックフィールドの詳細については、サポートされているビュータイプの一覧を参照してください。
Cisco MDS リリース NX-OS リリース 8.3(2) より前は、sort 条件は metric フィールドであり、select 条件の下に一覧表示されている列の中に存在している必要がありました。Cisco MDS リリース NX-OS リリース 8.3(2) からは、sort 条件は metric または metadata フィールドであり、select 条件の下に一覧示されている列の中に存在している必要があります。

ビュー

ビューは、ポート、イニシエータ、ターゲット、LUN、またはこれらの有効な組み合せに関するフローメトリックを表すものです。各ビュータイプは特定のフローメトリックをサポートしています。リソース使用率を最適化するために、オンボードクエリにはフローメトリックの長い名前が使用され、STS には短い名前が使用されます。詳細については、フローメトリックを参照してください。

サポートされているビュータイプの一覧

次の表に、サポートされているビュータイプを示します。

表 4. サポートされているビュータイプ
ビュータイプ	説明	キー
port	ポートのテーブルには、スイッチ上のポートのメタデータと IO メトリックが含まれています。	port
logical_port	論理ポートテーブルには、スイッチ上のポートに設定されている VSAN のメタデータと IO メトリックが含まれています。	port と vsan
scsi_target	ターゲットテーブルには、IO 操作を実行するスイッチ上のさまざまなポートの背後に展開されている SCSI ターゲットのメタデータと IO メトリックが含まれています。	port、vsan、および scsi-target-fc-id
scsi_initiator	イニシエータテーブルには、IO 操作を開始するスイッチ上のさまざまなポートの背後に展開されている SCSI イニシエータのメタデータと IO メトリックが含まれています。	port、vsan、および scsi-initiator-fc-id
scsi_target_app	ターゲットアプリケーションテーブルには、データがさまざまなターゲットでホストされているアプリケーションのメタデータと IO メトリックが含まれています。	port、vsan、scsi-target-fc-id、および app-id
scsi_initiator_app	イニシエータアプリケーションテーブルには、イニシエータが IO 操作を開始するアプリケーションのメタデータと IO メトリックが含まれています。	port、vsan、scsi-initiator-fc-id、および app-id
scsi_target_it_flow	ターゲット initiator-target（IT）フローテーブルには、さまざまな SCSI ターゲットと関連付けられている IT フローのメタデータと IO メトリックが含まれています。	port、vsan、scsi-target-fc-id、および scsi-initiator-fc-id
scsi_initiator_it_flow	イニシエータ IT フローテーブルには、さまざまな SCSI イニシエータと関連付けられている IT フローのメタデータと IO メトリックが含まれています。	port、vsan、scsi-initiator-fc-id、および scsi-target-fc-id
scsi_target_tl_flow	ターゲット target-LUN（TL）フローテーブルには、さまざまな SCSI ターゲットと関連付けられている LUN のメタデータと IO メトリックが含まれています。	port、vsan、scsi-target-fc-id、および lun-id
scsi_target_itl_flow	ターゲット initiator-target-LUN（ITL）フローテーブルには、さまざまな SCSI ターゲットと関連付けられている IT フローのメタデータと IO メトリックが含まれています。	port、vsan、scsi-target-fc-id、scsi-initiator-fc-id、および lun-id
scsi_initiator_itl_flow	イニシエータ ITL フローテーブルには、さまざまな SCSI イニシエータと関連付けられている ITL フローのメタデータと IO メトリックが含まれています。	port、vsan、scsi-initiator-fc-id、scsi-target-fc-id、および lun-id
scsi_target_io	ターゲット IO テーブルには、さまざまな SCSI ターゲットが実行するアクティブな IO の IO トランザクションの詳細が含まれています。	port、vsan、scsi-target-fc-id、scsi-initiator-fc-id、および ox-id
scsi_initiator_io	イニシエータ IO テーブルには、さまざまな SCSI イニシエータが開始するアクティブな IO の IO トランザクションの詳細が記録されています。	port、vsan、scsi-initiator-fc-id、scsi-target-fc-id、および ox-id

ビュータイプの表示

シスコでは、さまざまなビュータイプを説明するためのサンプルトポロジを考えました。以下は、次の図の説明です。

イニシエータ 1 とイニシエータ 2 は VSAN 1 に設定されていて、ゾーン 1 にあるターゲット 1、ターゲット 2、LUN 1、および LUN 2 と通信しています。
- イニシエータ 1 は、ターゲット 1 に対して 125 の読み取り IO を生成し、ターゲット 2 に対して 75 の読み取り IO を生成しています。
- イニシエータ 2 は、ターゲット 1 とターゲット 2 のそれぞれに対して 50 の読み取り IO を生成しています。
イニシエータ 3 は VSAN 2 に設定されていて、ゾーン 2 にあるターゲット 3、LUN 3、および LUN 4 と通信しています。

イニシエータ 3 は、ターゲット 3 に対して 300 の読み取り IO を生成しています。ターゲット 3 は、LUN 3 と LUN 4 のそれぞれに対して 150 の読み取り IO を生成しています。

（注）

次の図のカッコ内に記載されている情報はデバイスの FCID です。

サポートされているビュータイプの一覧とそれぞれの説明については、サポートされているビュータイプの一覧を参照してください。

次の図は、ポートビュータイプから見たフローメトリックを示しています。

表 5. ポートビュータイプ
ポート = fc 1/4 のポートビュー	total_read_io_count = 600（ポート上に表示されているすべてのイニシエータの読み取り I/O）

次の図は、論理ポートビュータイプから見たフローメトリックを示しています。

表 6. 論理ポートビュータイプ
ポート = fc 1/4、VSAN = 1 の論理ポートビュー	total_read_io_count = 300（VSAN 1 内のすべてのイニシエータの読み取り I/O）

次の図は、scsi_initiator ビュータイプから見たフローメトリックを示しています。

表 7. scsi_initiator ビュータイプ
ポート = fc 1/1、VSAN = 1、イニシエータ ID = 1.1.1 の scsi_initiator ビューポート = fc 1/5、VSAN = 1、イニシエータ ID = 1.1.1 の scsi_initiator ビュー	total_read_io_count = 200（イニシエータ ID 1.1.1 の読み取り I/O）
ポート = fc 1/5、VSAN = 1、イニシエータ ID = 1.1.2 の scsi_initiator ビュー	total_read_io_count = 100（イニシエータ ID 1.1.2 の読み取り I/O）
ポート = fc 1/5、VSAN = 2、イニシエータ ID = 1.1.3 の scsi_initiator ビュー	total_read_io_count = 300（イニシエータ ID 1.1.3 の読み取り I/O）

次の図は、scsi_target ビュータイプから見たフローメトリックを示しています。

表 8. scsi_target ビュータイプ
ポート = fc 1/6、VSAN = 1、ターゲット ID = 2.2.1 の scsi_target ビューポート = fc 1/4、VSAN = 1、ターゲット ID = 2.2.1 の scsi_target ビュー	total_read_io_count = 175（ターゲット ID 2.2.1 の読み取り I/O）
ポート = fc 1/4、VSAN = 1、ターゲット ID = 2.2.2 の scsi_target ビュー	total_read_io_count = 125（ターゲット ID 2.2.2 の読み取り I/O）
ポート = fc 1/4、VSAN = 2、ターゲット ID = 2.2.3 の scsi_target ビュー	total_read_io_count = 300（ターゲット ID 2.2.3 の読み取り I/O）

次の図は、scsi_initiator_it_flow ビュータイプから見たフローメトリックを示しています。

表 9. scsi_initiator_it_flow ビュータイプ
ポート = fc 1/1、VSAN = 1、イニシエータ ID = 1.1.1、ターゲット ID = 2.2.1 の scsi_initiator_it_flow ビューポート = fc 1/5、VSAN = 1、イニシエータ ID = 1.1.1、ターゲット ID = 2.2.1 の scsi_initiator_it_flow ビュー	total_read_io_count = 125（イニシエータ ID 1.1.1 とターゲット ID 2.2.1 間だけの読み取り I/O）
ポート = fc 1/1、VSAN = 1、イニシエータ ID = 1.1.1、ターゲット ID = 2.2.2 の scsi_initiator_it_flow ビューポート = fc 1/5、VSAN = 1、イニシエータ ID = 1.1.1、ターゲット ID = 2.2.2 の scsi_initiator_it_flow ビュー	total_read_io_count = 75（イニシエータ ID 1.1.1 とターゲット ID 2.2.2 間だけの読み取り I/O）
ポート = fc 1/5、VSAN = 1、イニシエータ ID = 1.1.2、ターゲット ID = 2.2.1 の scsi_initiator_it_flow ビュー	total_read_io_count = 50（イニシエータ ID 1.1.2 とターゲット ID 2.2.1 間だけの読み取り I/O）
ポート = fc 1/5、VSAN = 1、イニシエータ ID = 1.1.2、ターゲット ID = 2.2.2 の scsi_initiator_it_flow ビュー	total_read_io_count = 50（イニシエータ ID 1.1.2 とターゲット ID 2.2.2 間だけの読み取り I/O）
ポート = fc 1/5、VSAN = 2、イニシエータ ID = 1.1.3、ターゲット ID = 2.2.3 の scsi_initiator_it_flow ビュー	total_read_io_count = 300（イニシエータ ID 1.1.3 とターゲット ID 2.2.3 間だけの読み取り I/O）

次の図は、scsi_target_it_flow ビュータイプから見たフローメトリックを示しています。

表 10. scsi_target_it_flow ビュータイプ
ポート = fc 1/6、VSAN = 1、イニシエータ ID = 1.1.1、ターゲット ID = 2.2.1 の scsi_target_it_flow ビューポート = fc 1/4、VSAN = 1、イニシエータ ID = 1.1.1、ターゲット ID = 2.2.1 の scsi_target_it_flow ビュー	total_read_io_count = 125（イニシエータ ID 1.1.1 とターゲット ID 2.2.1 間だけの読み取り I/O）
ポート = fc 1/6、VSAN = 1、イニシエータ ID = 1.1.2、ターゲット ID = 2.2.1 の scsi_target_it_flow ビューポート = fc 1/4、VSAN = 1、イニシエータ ID = 1.1.2、ターゲット ID = 2.2.1 の scsi_target_it_flow ビュー	total_read_io_count = 50（イニシエータ ID 1.1.2 とターゲット ID 2.2.1 間だけの読み取り I/O）
ポート = fc 1/4、VSAN = 1、イニシエータ ID = 1.1.1、ターゲット ID = 2.2.2 の scsi_target_it_flow ビュー	total_read_io_count = 75（イニシエータ ID 1.1.1 とターゲット ID 2.2.2 間だけの読み取り I/O）
ポート = fc 1/4、VSAN = 1、イニシエータ ID = 1.1.2、ターゲット ID = 2.2.2 の scsi_target_it_flow ビュー	total_read_io_count = 50（イニシエータ ID 1.1.2 とターゲット ID 2.2.2 間だけの読み取り I/O）
ポート = fc 1/4、VSAN = 2、イニシエータ ID = 1.1.3、ターゲット ID = 2.2.3 の scsi_target_it_flow ビュー	total_read_io_count = 300（イニシエータ ID 1.1.3 とターゲット ID 2.2.3 間だけの読み取り I/O）

次の図は、scsi_initiator_itl_flow ビュータイプから見たフローメトリックを示しています。

表 11. scsi_initiator_itl_flow ビュータイプ
ポート = fc 1/1、VSAN = 1、イニシエータ ID = 1.1.1、ターゲット ID = 2.2.1、LUN ID = 0001 の scsi_initiator_itl_flow ビューポート = fc 1/5、VSAN = 1、イニシエータ ID = 1.1.1、ターゲット ID = 2.2.1、LUN ID = 0001 の scsi_initiator_itl_flow ビュー	total_read_io_count = 125（イニシエータ ID 1.1.1、ターゲット ID 2.2.1、および LUN ID 0001 間だけの読み取り I/O）
ポート = fc 1/1、VSAN = 1、イニシエータ ID = 1.1.1、ターゲット ID = 2.2.2、LUN ID = 0002 の scsi_initiator_itl_flow ビューポート = fc 1/5、VSAN = 1、イニシエータ ID = 1.1.1、ターゲット ID = 2.2.2、LUN ID = 0002 の scsi_initiator_itl_flow ビュー	total_read_io_count = 75（イニシエータ ID 1.1.1、ターゲット ID 2.2.2、および LUN ID 0002 間だけの読み取り I/O）
ポート = fc 1/5、VSAN = 1、イニシエータ ID = 1.1.2、ターゲット ID = 2.2.1、LUN ID = 0001 の scsi_initiator_itl_flow ビューポート = fc 1/5、VSAN = 1、イニシエータ ID = 1.1.2、ターゲット ID = 2.2.2、LUN ID = 0002 の scsi_initiator_itl_flow ビュー	total_read_io_count = 50（イニシエータ ID 1.1.2、ターゲット ID 2.2.1、および LUN ID 0001 とイニシエータ ID 1.1.2、ターゲット ID 2.2.2、および LUN ID 0002 間だけの読み取り I/O）
ポート = fc 1/5、VSAN = 2、イニシエータ ID = 1.1.3、ターゲット ID = 2.2.3、LUN ID = 0003 の scsi_initiator_itl_flow ビューポート = fc 1/5、VSAN = 2、イニシエータ ID = 1.1.3、ターゲット ID = 2.2.3、LUN ID = 0004 の scsi_initiator_itl_flow ビュー	total_read_io_count = 150（イニシエータ ID 1.1.3、ターゲット ID 2.2.3、および LUN ID 0003 とイニシエータ ID 1.1.3、ターゲット ID 2.2.3、および LUN ID 0004 間だけの読み取り I/O）

次の図は、scsi_target_itl_flow ビュータイプから見たフローメトリックを示しています。

表 12. scsi_target_itl_flow ビュータイプ
ポート = fc 1/6、VSAN = 1、イニシエータ ID = 1.1.1、ターゲット ID = 2.2.1、LUN ID = 0001 の scsi_target_itl_flow ビューポート = fc 1/4、VSAN = 1、イニシエータ ID = 1.1.1、ターゲット ID = 2.2.1、LUN ID = 0001 の scsi_target_itl_flow ビュー	total_read_io_count = 125（イニシエータ ID 1.1.1、ターゲット ID 2.2.1、および LUN ID 0001 間だけの読み取り I/O）
ポート = fc 1/6、VSAN = 1、イニシエータ ID = 1.1.2、ターゲット ID = 2.2.1、LUN ID = 0001 の scsi_target_itl_flow ビューポート = fc 1/4、VSAN = 1、イニシエータ ID = 1.1.2、ターゲット ID = 2.2.1、LUN ID = 0001 の scsi_target_itl_flow ビュー	total_read_io_count = 50（イニシエータ ID 1.1.2、ターゲット ID 2.2.1、および LUN ID 0001 間だけの読み取り I/O）
ポート = fc 1/4、VSAN = 1、イニシエータ ID = 1.1.1、ターゲット ID = 2.2.2、LUN ID = 0002 の scsi_target_itl_flow ビュー	total_read_io_count = 75（イニシエータ ID 1.1.1、ターゲット ID 2.2.2、および LUN ID 0002 間だけの読み取り I/O）
ポート = fc 1/4、VSAN = 1、イニシエータ ID = 1.1.2、ターゲット ID = 2.2.2、LUN ID = 0002 の scsi_target_itl_flow ビュー	total_read_io_count = 50（イニシエータ ID 1.1.2、ターゲット ID 2.2.2、および LUN ID 0002 間だけの読み取り I/O）
ポート = fc 1/4、VSAN = 2、イニシエータ ID = 1.1.3、ターゲット ID = 2.2.3、LUN ID = 0003 の scsi_target_itl_flow ビューポート = fc 1/4、VSAN = 2、イニシエータ ID = 1.1.3、ターゲット ID = 2.2.3、LUN ID = 0004 の scsi_target_itl_flow ビュー	total_read_io_count = 150（イニシエータ ID 1.1.3、ターゲット ID 2.2.3、および LUN ID 0003 とイニシエータ ID 1.1.3、ターゲット ID 2.2.3、および LUN ID 0004 間だけの読み取り I/O）

次の図は、scsi_target_tl_flow ビュータイプから見たフローメトリックを示しています。

表 13. scsi_target_tl_flow ビュータイプ
ポート = fc 1/6、VSAN = 1、ターゲット ID = 2.2.1、LUN ID = 0001 の scsi_target_tl_flow ビューポート = fc 1/4、VSAN = 1、ターゲット ID = 2.2.1、LUN ID = 0001 の scsi_target_tl_flow ビュー	total_read_io_count = 175（ターゲット ID 2.2.1 と LUN ID 0001 間だけの読み取り I/O）
ポート = fc 1/4、VSAN = 1、ターゲット ID = 2.2.2、LUN ID = 0002 の scsi_target_tl_flow ビュー	total_read_io_count = 125（ターゲット ID 2.2.2 と LUN ID 0002 間だけの読み取り I/O）
ポート = fc 1/4、VSAN = 2、ターゲット ID = 2.2.3、LUN ID = 0003 の scsi_target_tl_flow ビューポート = fc 1/4、VSAN = 2、ターゲット ID = 2.2.3、LUN ID = 0004 の scsi_target_tl_flow ビュー	total_read_io_count = 150（ターゲット ID 2.2.3 と LUN ID 0003 およびターゲット ID 2.2.3 と LUN ID 0004 間だけの読み取り I/O）

次の図は、total_read_io_count が 0 のイニシエータビューを示しています。

図 24. total_read_io_count が 0 のイニシエータビュー

次の図は、total_read_io_count が 0 のターゲットビューを示しています。

例：クエリ構文の設定

show analytics query 'select all from fc-scsi.scsi_initiator' コマンドを実行すると、次の図に示されているサンプルデータベースで確認できるように、すべてのイニシエータのフローメトリックが出力されます。

show analytics query 'select total_read_io_count from fc-scsi.scsi_initiator' コマンドを実行すると、次の図に示されているサンプルデータベースで確認できるように、ターゲットの total_read_io_count フローメトリックが出力されます。

show analytics query 'select total_read_io_count,total_write_io_count from fc-scsi.scsi_target_it_flow’ コマンドを実行すると、次の図に示されているサンプルデータベースで確認できるように、ターゲットから見たイニシエータとターゲットの total_read_io_count および total_write_io_count フローメトリックが出力されます。

図 28. イニシエータとターゲットの読み取り IO 総数と書き込み IO 総数のフローメトリック

show analytics query 'select all from fc-scsi.port where port=fc1/1 and vsan=2 limit 1’ コマンドを実行すると、次の図に示されているサンプルデータベースで確認できるように、レコードの数が 1 に制限されているポート fc1/1、VSAN 2 の一部であるポートのフローメトリックが出力されます。

図 29. レコードの数が 1 に制限されている VSAN 2 に属しているポート FC 1/1 のフローメトリック

show analytics query 'select all from fc-scsi.scsi_initiator where port=fc1/1 and vsan=3 sort total_write_io_count’ コマンドを実行すると、次の図のサンプルデータベースで確認できるように、ポート fc1/1 および VSAN 3 の一部であるイニシエータの total_write_io_count フローメトリックが出力されます。出力はソートされています。

図 30. ポート FC1/1 と VSAN 3 に属しているイニシエータの書き込み IO 総数のフローメトリック（出力はソート済み）

SAN アナリティクスの設定

インターフェイスからのフローメトリックの収集を有効にするには、スイッチとそのインターフェイスの両方で SAN アナリティクス機能を有効にします。

（注）

SAN アナリティクス機能を使用するには、install license コマンドを使用して適切なライセンスパッケージをインストールする必要があります。詳細については、Cisco MDS 9000 シリーズライセンスガイド [英語] を参照してください。
DCNM SAN Insights を使用している場合は、DCNM SAN Insights で SAN アナリティクス機能を設定できます。スイッチでこの機能を設定する必要はありません。詳細については、Cisco DCNM SAN 管理コンフィギュレーションガイド [英語] の「Configuring SAN Insights」セクションを参照してください。

SAN アナリティクスの有効化

（注）

SAN アナリティクス機能は、デフォルトでは無効になっています。
アクティブな ITL 数が記載されている制限を超えると、Syslog メッセージが記録されます。SAN アナリティクス機能を設定後すぐに logging level analytics 4 コマンドを設定して、スイッチでこの Syslog が記録されるようにすることをお勧めします。

スイッチの SAN アナリティクス機能を有効にするには、次の手順を実行します。

手順

ステップ 1

グローバルコンフィギュレーションモードを開始します。

switch# configure terminal

ステップ 2

スイッチの SAN アナリティクス機能を有効にします。

switch(config)# feature analytics

SAN アナリティクスの無効化

スイッチの SAN アナリティクス機能を無効にするには、次の手順を実行します。

手順

ステップ 1

グローバルコンフィギュレーションモードを開始します。

switch# configure terminal

ステップ 2

スイッチの SAN アナリティクス機能を無効にします。

switch(config)# no feature analytics

インターフェイスでの SAN アナリティクスの有効化

インターフェイスの SAN アナリティクス機能を有効にするには、次の手順を実行します。

始める前に

（注）

SAN アナリティクス機能は、デフォルトではすべてのインターフェイスで無効になっています。

スイッチの SAN アナリティクス機能を有効にします。SAN アナリティクスの有効化の項を参照してください。
ポートチャネルで、すべてのインターフェイスで SAN アナリティクス機能を有効にします。

手順

ステップ 1

グローバルコンフィギュレーションモードを開始します。

switch# configure terminal

ステップ 2

ファイバチャネルインターフェイスまたはインターフェイスの範囲を選択し、インターフェイスコンフィギュレーションサブモードを開始します。

switch(config)# interface fc slot number/port number

（注）

interface fc slot number/port number - port number、fc slot number/port number - port number コマンドを使用して、インターフェイスの範囲を指定することもできます。ダッシュ（-）とカンマ（,）の前後にはスペースが必要です。

ステップ 3

選択されたインターフェイスの SAN アナリティクス機能を有効にします。

switch(config-if)# analytics type fc-scsi

（注）

Cisco MDS NX-OS リリース 8.2(1) および Cisco MDS NX-OS リリース 8.3(1) では、fc-scsi タイプのみサポートされています。

インターフェイスでの SAN アナリティクスの無効化

インターフェイスの SAN アナリティクス機能を無効にするには、次の手順を実行します。

始める前に

ポートチャネルで、すべてのインターフェイスの SAN アナリティクス機能を無効にします。

手順

ステップ 1

グローバルコンフィギュレーションモードを開始します。

switch# configure terminal

ステップ 2

ファイバチャネルインターフェイスまたはインターフェイスの範囲を選択し、インターフェイスコンフィギュレーションサブモードを開始します。

switch(config)# interface fc slot number/port number

（注）

ステップ 3

選択されたインターフェイスで SAN アナリティクス機能を無効にします。

switch(config-if)# no analytics type fc-scsi

ポートサンプリングの有効化

（注）

ポートサンプリングは、Cisco MDS NX-OS リリース 8.3(1) 以降のリリースでのみサポートされています。
ポートサンプリングはデフォルトでは無効になっており、継続的な監視はすべての分析対応ポートで有効になっています。ポートサンプリングの詳細については、ポートサンプリングを参照してください。

モジュールのポートサンプリングを有効にするには、次の手順を実行します。

手順

ステップ 1

グローバルコンフィギュレーションモードを開始します。

switch# configure terminal

ステップ 2

モジュールのポートサンプリングを有効にします。

switch# analytics port-sampling module number size number interval seconds

ポートサンプリングの無効化

モジュールのポートサンプリングを無効にするには、次の手順を実行します。

手順

ステップ 1

グローバルコンフィギュレーションモードを開始します。

switch# configure terminal

ステップ 2

モジュールのポートサンプリングを無効にして、設定済みのストリーミングサンプル間隔を指定して、すべての分析対応ポートの監視をデフォルトモードに戻します。

switch# no analytics port-sampling module number

例：SAN アナリティクスの設定

次に、スイッチの SAN アナリティクス機能を有効にする例を示します。


switch# configure terminal
switch(config)# feature analytics

次に、スイッチの SAN アナリティクス機能を無効にする例を示します。


switch# configure terminal
switch(config)# no feature analytics

次に、インターフェイスの SAN アナリティクス機能を有効にする例を示します。


switch# configure terminal
switch(config)# interface fc 1/1
switch(config-if)# analytics type fc-scsi

次に、インターフェイスの SAN アナリティクス機能を無効にする例を示します。


switch# configure terminal
switch(config)# interface fc 1/1
switch(config-if)# no analytics type fc-scsi

次に、インターフェイスの範囲の SAN アナリティクス機能を有効にする例を示します。


switch# configure terminal
switch(config)# interface fc1/1 - 4 , fc2/1 - 3
switch(config-if)# analytics type fc-scsi

次に、インターフェイスの範囲の SAN アナリティクス機能を無効にする例を示します。


switch# configure terminal
switch(config)# interface fc1/1 - 4 , fc2/1 - 3
switch(config-if)# no analytics type fc-scsi

次に、35 秒のポートサンプリング間隔のポートサンプリングをモジュールで有効にする例を示します。


switch# configure terminal
switch(config)# analytics port-sampling module 2 size 12 interval 35

次に、モジュールのポートサンプリングを無効にして、設定済みのストリーミングサンプル間隔を指定して、すべての分析対応ポートの監視をデフォルトモードに戻す例を示します。


switch# configure terminal
switch(config)# no analytics port-sampling module 2

クエリの作成と使用

フローメトリックは、クエリ構文の形式である query_string を使用して分析されます。

インストールされているプッシュクエリの表示

インストールされているプッシュクエリを表示するには、次のコマンドを実行します。

switch# show analytics query { all | name query_name}

プッシュクエリの結果の表示

プッシュクエリの結果を表示するには、次のコマンドを実行します。

switch# show analytics query name query_name result

プルクエリの実行

プルクエリを実行するには、次のコマンドを実行します。

switch# show analytics query “query_string” [clear ] [differential ]

（注）

"query_string" を使用して、“select all from fc-scsi.port” のように、select、table、limit などのクエリセマンティックを指定します。

プッシュクエリの設定

プッシュクエリを設定するには、次の手順を実行します。

手順

ステップ 1

グローバルコンフィギュレーションモードを開始します。

switch# configure terminal

ステップ 2

特定の間隔で表示されるフローメトリックのクエリ文字列とタイマー値を指定します。

switch(config)# analytics query “query_string” name query_name type periodic [interval seconds] [clear ] [differential ]

"query_string" を使用したプッシュクエリは、一度に 1 つのみ許可されます。重複するプッシュクエリ名を設定しようとすると、現在の設定が重複していることを示すメッセージが表示されます。

（注）

プルクエリ、プッシュクエリ、およびオーバーレイ CLI は、SAN アナリティクス機能が有効になっているインターフェイスにのみ適用されます。

設定されているプッシュクエリの削除

設定されているプッシュクエリを削除するには、次の手順を実行します。

手順

ステップ 1

グローバルコンフィギュレーションモードを開始します。

switch# configure terminal

ステップ 2

設定されているプッシュクエリを削除します。

switch(config)# no analytics name query_name

メトリックのクリア

（注）

"query_string" は "select all from <view-name>" の形式である必要があります。
フローメトリックは、プッシュクエリをインストールしなくてもクリアできます。
ビューは、ポート、イニシエータ、ターゲット、LUN、またはこれらの有効な組み合せに関するフローメトリックを表すものです。クリアは、ビューインスタンスのすべてのフローメトリックをリセットします。消去は、特定のビューインスタンスとその関連フローメトリックを一瞬で削除します。データベースをクリアまたは消去しても、データベースは指定された “query_string” のフローメトリックの収集を続けます。
clear analytics query コマンドは、プッシュクエリで使用されている clear オプションとは異なります。clear analytics query コマンドは、クエリ構文を満たすすべてのメトリックをリセットします。プッシュクエリで使用される clear オプションは、最小、最大、およびピークフローメトリックをリセットするだけです。

クエリ文字列に一致するビューインスタンスのすべてのフローメトリックをリセットするには、次のコマンドを実行します。

switch# clear analytics query “query_string”

ビューの消去

特定のビューインスタンスとその関連メトリックを削除するには、次のコマンドを実行します。

switch# purge analytics query “query_string”

（注）

"query_string" は "select all from <view-name>" の形式である必要があります。
フローメトリックは、プッシュクエリをインストールしなくてもクリアできます。
消去クエリの where 句には、port キーフィールドのみ指定できます。
ビューは、ポート、イニシエータ、ターゲット、LUN、またはこれらの有効な組み合せに関するフローメトリックを表すものです。クリアは、ビューインスタンスのすべてのフローメトリックをリセットします。消去は、特定のビューインスタンスとその関連フローメトリックを一瞬で削除します。データベースをクリアまたは消去しても、データベースは指定された “query_string” のフローメトリックの収集を続けます。

設定されているプッシュクエリの結果の表示

show analytics query name query_name result コマンドを使用して表示されているフローメトリックは、このコマンドの実行時の時間間隔で更新されたメトリックです。たとえば、プッシュクエリが 30 秒間隔で更新するように設定されている場合、show analytics query name query_name result コマンドは 35 秒後に実行され、プッシュクエリでは、時間間隔が 30 秒のときに更新されたフローメトリックが表示されます。

設定されているプッシュクエリのフローメトリックを表示するには、次のコマンドを実行します。

switch# show analytics query name query_name result

例：クエリの作成と使用

（注）

出力の “values” の後にある番号は、対応するレコードの番号を示しています。
Cisco MDS NX-OS リリース 8.3(1) では新しいメトリックが追加されています。これは、Cisco MDS NX-OS リリース 8.3(1) 以降のリリースと Cisco MDS NX-OS リリース 8.2(1) の間でクエリの結果が少し異なる可能性があるためです。

次に、イニシエータ ITL フロービューインスタンスのすべてのフローメトリックの出力の例を示します。


switch#  show analytics query 'select all from fc-scsi.scsi_initiator_itl_flow'
{ "values": {
        "1": {
                "port": "fc1/1",
                "vsan": "10",
                "app_id": "255",
                "initiator_id": "0xe80041",
                "target_id": "0xd60200",
                "lun": "0000-0000-0000-0000",
                "active_io_read_count": "0",
                "active_io_write_count": "1",
                "total_read_io_count": "0",
                "total_write_io_count": "1162370362",
                "total_seq_read_io_count": "0",
                "total_seq_write_io_count": "1",
                "total_read_io_time": "0",
                "total_write_io_time": "116204704658",
                "total_read_io_initiation_time": "0",
                "total_write_io_initiation_time": "43996934029",
                "total_read_io_bytes": "0",
                "total_write_io_bytes": "595133625344",
                "total_read_io_inter_gap_time": "0",
                "total_write_io_inter_gap_time": "41139462314556",
                "total_time_metric_based_read_io_count": "0",
                "total_time_metric_based_write_io_count": "1162370358",
                "total_time_metric_based_read_io_bytes": "0",
                "total_time_metric_based_write_io_bytes": "595133623296",
                "read_io_rate": "0",
                "peak_read_io_rate": "0",
                "write_io_rate": "7250",
                "peak_write_io_rate": "7304",
                "read_io_bandwidth": "0",
                "peak_read_io_bandwidth": "0",
                "write_io_bandwidth": "3712384",
                "peak_write_io_bandwidth": "3739904",
                "read_io_size_min": "0",
                "read_io_size_max": "0",
                "write_io_size_min": "512",
                "write_io_size_max": "512",
                "read_io_completion_time_min": "0",
                "read_io_completion_time_max": "0",
                "write_io_completion_time_min": "89",
                "write_io_completion_time_max": "416",
                "read_io_initiation_time_min": "0",
                "read_io_initiation_time_max": "0",
                "write_io_initiation_time_min": "34",
                "write_io_initiation_time_max": "116",
                "read_io_inter_gap_time_min": "0",
                "read_io_inter_gap_time_max": "0",
                "write_io_inter_gap_time_min": "31400",
                "write_io_inter_gap_time_max": "118222",
                "peak_active_io_read_count": "0",
                "peak_active_io_write_count": "5",
                "read_io_aborts": "0",
                "write_io_aborts": "0",
                "read_io_failures": "0",
                "write_io_failures": "0",
                "read_io_scsi_check_condition_count": "0",
                "write_io_scsi_check_condition_count": "0",
                "read_io_scsi_busy_count": "0",
                "write_io_scsi_busy_count": "0",
                "read_io_scsi_reservation_conflict_count": "0",
                "write_io_scsi_reservation_conflict_count": "0",
                "read_io_scsi_queue_full_count": "0",
                "write_io_scsi_queue_full_count": "0",
                "sampling_start_time": "1528535447",
                "sampling_end_time": "1528697457"
        },
       .
       .
       .
        "5": {
                "port": "fc1/8",
                "vsan": "10",
                "app_id": "255",
                "initiator_id": "0xe80001",
                "target_id": "0xe800a1",
                "lun": "0000-0000-0000-0000",
                "active_io_read_count": "0",
                "active_io_write_count": "1",
                "total_read_io_count": "0",
                "total_write_io_count": "1138738309",
                "total_seq_read_io_count": "0",
                "total_seq_write_io_count": "1",
                "total_read_io_time": "0",
                "total_write_io_time": "109792480881",
                "total_read_io_initiation_time": "0",
                "total_write_io_initiation_time": "39239145641",
                "total_read_io_bytes": "0",
                "total_write_io_bytes": "583034014208",
                "total_read_io_inter_gap_time": "0",
                "total_write_io_inter_gap_time": "41479779998852",
                "total_time_metric_based_read_io_count": "0",
                "total_time_metric_based_write_io_count": "1138738307",
                "total_time_metric_based_read_io_bytes": "0",
                "total_time_metric_based_write_io_bytes": "583034013184",
                "read_io_rate": "0",
                "peak_read_io_rate": "0",
                "write_io_rate": "7074",
                "peak_write_io_rate": "7903",
                "read_io_bandwidth": "0",
                "peak_read_io_bandwidth": "0",
                "write_io_bandwidth": "3622144",
                "peak_write_io_bandwidth": "4046336",
                "read_io_size_min": "0",
                "read_io_size_max": "0",
                "write_io_size_min": "512",
                "write_io_size_max": "512",
                "read_io_completion_time_min": "0",
                "read_io_completion_time_max": "0",
                "write_io_completion_time_min": "71",
                "write_io_completion_time_max": "3352",
                "read_io_initiation_time_min": "0",
                "read_io_initiation_time_max": "0",
                "write_io_initiation_time_min": "26",
                "write_io_initiation_time_max": "2427",
                "read_io_inter_gap_time_min": "0",
                "read_io_inter_gap_time_max": "0",
                "write_io_inter_gap_time_min": "25988",
                "write_io_inter_gap_time_max": "868452",
                "peak_active_io_read_count": "0",
                "peak_active_io_write_count": "5",
                "read_io_aborts": "0",
                "write_io_aborts": "0",
                "read_io_failures": "0",
                "write_io_failures": "0",
                "read_io_scsi_check_condition_count": "0",
                "write_io_scsi_check_condition_count": "0",
                "read_io_scsi_busy_count": "0",
                "write_io_scsi_busy_count": "0",
                "read_io_scsi_reservation_conflict_count": "0",
                "write_io_scsi_reservation_conflict_count": "0",
                "read_io_scsi_queue_full_count": "0",
                "write_io_scsi_queue_full_count": "0",
                "sampling_start_time": "1528535447",
                "sampling_end_time": "1528697457"
        }
}}

次に、イニシエータ ITL フロービューインスタンスの特定のイニシエータ ID に関する特定のフローメトリックを要求した場合の出力の例を示します。


switch#   show analytics query 'select port,initiator_id,target_id,lun,total_read_io_count,total_write_io_count,read_io_rate,write_io_rate from fc-scsi.scsi_initiator_itl_flow where initiator_id=0xe80001'
{ "values": {
        "1": {
                "port": "fc1/8",
                "initiator_id": "0xe80001",
                "target_id": "0xe800a1",
                "lun": "0000-0000-0000-0000",
                "total_read_io_count": "0",
                "total_write_io_count": "1139010960",
                "read_io_rate": "0",
                "write_io_rate": "7071",
                "sampling_start_time": "1528535447",
                "sampling_end_time": "1528697495"
        }
}}

次に、イニシエータ ITL フロービューインスタンスの特定のイニシエータ ID と LUN に関する特定のフローメトリックを要求した場合の出力の例を示します。


switch#   show analytics query 'select port,initiator_id,target_id,lun,total_read_io_count,total_write_io_count,read_io_rate,write_io_rate from fc-scsi.scsi_initiator_itl_flow where initiator_id=0xe80001 and lun=0000-0000-0000-0000'
{ "values": {
        "1": {
                "port": "fc1/8",
                "initiator_id": "0xe80001",
                "target_id": "0xe800a1",
                "lun": "0000-0000-0000-0000",
                "total_read_io_count": "0",
                "total_write_io_count": "1139453979",
                "read_io_rate": "0",
                "write_io_rate": "7070",
                "sampling_start_time": "1528535447",
                "sampling_end_time": "1528697559"
        }
}}

次に、特定の LUN の特定のフローメトリックの出力とターゲット ITL フロービューインスタンスの write_io_rate メトリックのソートされた出力の例を示します。


switch#   show analytics query 'select port,initiator_id,target_id,lun,total_read_io_count,total_write_io_count,read_io_rate,write_io_rate from fc-scsi.scsi_target_itl_flow where lun=0000-0000-0000-0000 sort write_io_rate'
{ "values": {
        "1": {
                "port": "fc1/6",
                "initiator_id": "0xe80020",
                "target_id": "0xd60040",
                "lun": "0000-0000-0000-0000",
                "total_read_io_count": "0",
                "total_write_io_count": "1103394068",
                "read_io_rate": "0",
                "write_io_rate": "6882",
                "sampling_start_time": "1528535447",
                "sampling_end_time": "1528697630"
        },
        "2": {
                "port": "fc1/6",
                "initiator_id": "0xe80021",
                "target_id": "0xe80056",
                "lun": "0000-0000-0000-0000",
                "total_read_io_count": "0",
                "total_write_io_count": "1119199742",
                "read_io_rate": "0",
                "write_io_rate": "6946",
                "sampling_start_time": "1528535447",
                "sampling_end_time": "1528697630"
        },
        "3": {
                "port": "fc1/8",
                "initiator_id": "0xe80000",
                "target_id": "0xe80042",
                "lun": "0000-0000-0000-0000",
                "total_read_io_count": "0",
                "total_write_io_count": "1119506589",
                "read_io_rate": "0",
                "write_io_rate": "6948",
                "sampling_start_time": "1528535447",
                "sampling_end_time": "1528697630"
        },
        "4": {
                "port": "fc1/8",
                "initiator_id": "0xe80001",
                "target_id": "0xe800a1",
                "lun": "0000-0000-0000-0000",
                "total_read_io_count": "0",
                "total_write_io_count": "1139953183",
                "read_io_rate": "0",
                "write_io_rate": "7068",
                "sampling_start_time": "1528535447",
                "sampling_end_time": "1528697630"
        },
        "5": {
                "port": "fc1/1",
                "initiator_id": "0xe80041",
                "target_id": "0xd60200",
                "lun": "0000-0000-0000-0000",
                "total_read_io_count": "0",
                "total_write_io_count": "1163615698",
                "read_io_rate": "0",
                "write_io_rate": "7247",
                "sampling_start_time": "1528535447",
                "sampling_end_time": "1528697630"
        }
}}

次に、出力が 3 レコードに制限されている、特定の LUN の特定のフローメトリックの出力とイニシエータ ITL フロービューインスタンスの write_io_rate メトリックのソートされた出力の例を示します。


switch#   show analytics query 'select port,initiator_id,target_id,lun,total_read_io_count,total_write_io_count,read_io_rate,write_io_rate from fc-scsi.scsi_initiator_itl_flow where lun=0000-0000-0000-0000 sort write_io_rate limit 3'
{ "values": {
        "1": {
                "port": "fc1/6",
                "initiator_id": "0xe80020",
                "target_id": "0xd60040",
                "lun": "0000-0000-0000-0000",
                "total_read_io_count": "0",
                "total_write_io_count": "1103901828",
                "read_io_rate": "0",
                "write_io_rate": "6885",
                "sampling_start_time": "1528535447",
                "sampling_end_time": "1528697704"
        },
        "2": {
                "port": "fc1/8",
                "initiator_id": "0xe80000",
                "target_id": "0xe80042",
                "lun": "0000-0000-0000-0000",
                "total_read_io_count": "0",
                "total_write_io_count": "1120018575",
                "read_io_rate": "0",
                "write_io_rate": "6940",
                "sampling_start_time": "1528535447",
                "sampling_end_time": "1528697704"
        },
        "3": {
                "port": "fc1/6",
                "initiator_id": "0xe80021",
                "target_id": "0xe80056",
                "lun": "0000-0000-0000-0000",
                "total_read_io_count": "0",
                "total_write_io_count": "1119711583",
                "read_io_rate": "0",
                "write_io_rate": "6942",
                "sampling_start_time": "1528535447",
                "sampling_end_time": "1528697704"
        }
}}

次に、イニシエータ ITL フロービューインスタンスの特定の LUN とターゲット ID に関する特定のフローメトリックの出力の例を示します。


switch#   show analytics query 'select port,initiator_id,target_id,lun,total_read_io_count,total_write_io_count,read_io_rate,write_io_rate from fc-scsi.scsi_initiator_itl_flow where lun=0000-0000-0000-0000 and target_id=0xe800a1'
{ "values": {
        "1": {
                "port": "fc1/8",
                "initiator_id": "0xe80001",
                "target_id": "0xe800a1",
                "lun": "0000-0000-0000-0000",
                "total_read_io_count": "0",
                "total_write_io_count": "1139010960",
                "read_io_rate": "0",
                "write_io_rate": "7071"
                "sampling_start_time": "1528535447",
                "sampling_end_time": "1528697495"
        }
}}

次に、フローメトリックの更新期間がデフォルトの期間の 30 秒に設定されている場合のプッシュクエリの設定の例を示します。


switch# configure terminal
switch(config)# analytics query 'select all from fc-scsi.scsi_initiator_itl_flow' name initiator_itl_flow type periodic
switch(config)# show analytics query name initiator_itl_flow result 
{ "values": {
        "1": {
                "port": "fc1/1",
                "vsan": "10",
                "app_id": "255",
                "initiator_id": "0xe80041",
                "target_id": "0xd60200",
                "lun": "0000-0000-0000-0000",
                "active_io_read_count": "0",
                "active_io_write_count": "1",
                "total_read_io_count": "0",
                "total_write_io_count": "1162370362",
                "total_seq_read_io_count": "0",
                "total_seq_write_io_count": "1",
                "total_read_io_time": "0",
                "total_write_io_time": "116204704658",
                "total_read_io_initiation_time": "0",
                "total_write_io_initiation_time": "43996934029",
                "total_read_io_bytes": "0",
                "total_write_io_bytes": "595133625344",
                "total_read_io_inter_gap_time": "0",
                "total_write_io_inter_gap_time": "41139462314556",
                "total_time_metric_based_read_io_count": "0",
                "total_time_metric_based_write_io_count": "1162370358",
                "total_time_metric_based_read_io_bytes": "0",
                "total_time_metric_based_write_io_bytes": "595133623296",
                "read_io_rate": "0",
                "peak_read_io_rate": "0",
                "write_io_rate": "7250",
                "peak_write_io_rate": "7304",
                "read_io_bandwidth": "0",
                "peak_read_io_bandwidth": "0",
                "write_io_bandwidth": "3712384",
                "peak_write_io_bandwidth": "3739904",
                "read_io_size_min": "0",
                "read_io_size_max": "0",
                "write_io_size_min": "512",
                "write_io_size_max": "512",
                "read_io_completion_time_min": "0",
                "read_io_completion_time_max": "0",
                "write_io_completion_time_min": "89",
                "write_io_completion_time_max": "416",
                "read_io_initiation_time_min": "0",
                "read_io_initiation_time_max": "0",
                "write_io_initiation_time_min": "34",
                "write_io_initiation_time_max": "116",
                "read_io_inter_gap_time_min": "0",
                "read_io_inter_gap_time_max": "0",
                "write_io_inter_gap_time_min": "31400",
                "write_io_inter_gap_time_max": "118222",
                "peak_active_io_read_count": "0",
                "peak_active_io_write_count": "5",
                "read_io_aborts": "0",
                "write_io_aborts": "0",
                "read_io_failures": "0",
                "write_io_failures": "0",
                "read_io_scsi_check_condition_count": "0",
                "write_io_scsi_check_condition_count": "0",
                "read_io_scsi_busy_count": "0",
                "write_io_scsi_busy_count": "0",
                "read_io_scsi_reservation_conflict_count": "0",
                "write_io_scsi_reservation_conflict_count": "0",
                "read_io_scsi_queue_full_count": "0",
                "write_io_scsi_queue_full_count": "0",
                "sampling_start_time": "1528535447",
                "sampling_end_time": "1528697457"
        },
        .
        .
        .
        "5": {
                "port": "fc1/8",
                "vsan": "10",
                "app_id": "255",
                "initiator_id": "0xe80001",
                "target_id": "0xe800a1",
                "lun": "0000-0000-0000-0000",
                "active_io_read_count": "0",
                "active_io_write_count": "1",
                "total_read_io_count": "0",
                "total_write_io_count": "1138738309",
                "total_seq_read_io_count": "0",
                "total_seq_write_io_count": "1",
                "total_read_io_time": "0",
                "total_write_io_time": "109792480881",
                "total_read_io_initiation_time": "0",
                "total_write_io_initiation_time": "39239145641",
                "total_read_io_bytes": "0",
                "total_write_io_bytes": "583034014208",
                "total_read_io_inter_gap_time": "0",
                "total_write_io_inter_gap_time": "41479779998852",
                "total_time_metric_based_read_io_count": "0",
                "total_time_metric_based_write_io_count": "1138738307",
                "total_time_metric_based_read_io_bytes": "0",
                "total_time_metric_based_write_io_bytes": "583034013184",
                "read_io_rate": "0",
                "peak_read_io_rate": "0",
                "write_io_rate": "7074",
                "peak_write_io_rate": "7903",
                "read_io_bandwidth": "0",
                "peak_read_io_bandwidth": "0",
                "write_io_bandwidth": "3622144",
                "peak_write_io_bandwidth": "4046336",
                "read_io_size_min": "0",
                "read_io_size_max": "0",
                "write_io_size_min": "512",
                "write_io_size_max": "512",
                "read_io_completion_time_min": "0",
                "read_io_completion_time_max": "0",
                "write_io_completion_time_min": "71",
                "write_io_completion_time_max": "3352",
                "read_io_initiation_time_min": "0",
                "read_io_initiation_time_max": "0",
                "write_io_initiation_time_min": "26",
                "write_io_initiation_time_max": "2427",
                "read_io_inter_gap_time_min": "0",
                "read_io_inter_gap_time_max": "0",
                "write_io_inter_gap_time_min": "25988",
                "write_io_inter_gap_time_max": "868452",
                "peak_active_io_read_count": "0",
                "peak_active_io_write_count": "5",
                "read_io_aborts": "0",
                "write_io_aborts": "0",
                "read_io_failures": "0",
                "write_io_failures": "0",
                "read_io_scsi_check_condition_count": "0",
                "write_io_scsi_check_condition_count": "0",
                "read_io_scsi_busy_count": "0",
                "write_io_scsi_busy_count": "0",
                "read_io_scsi_reservation_conflict_count": "0",
                "write_io_scsi_reservation_conflict_count": "0",
                "read_io_scsi_queue_full_count": "0",
                "write_io_scsi_queue_full_count": "0",
                "sampling_start_time": "1528535447",
                "sampling_end_time": "1528697457"
        }
}}

次に、最小、最大、およびピークフローメトリックをすべてクリアする例を示します。

次に、最小、最大、およびピークフローメトリックをすべてクリアする前の出力の例を示します。

（注）

show analytics query "query_string" clear コマンドは、clear-on-push または clear-on-pull コマンドです。そのため、初回実行時にはこのコマンドは適用されません。


switch# show analytics query "select all from  fc-scsi.scsi_target_itl_flow where port=fc1/17" clear
{ "values": {
        "1": {
                "port": "fc1/17",
                "vsan": "1",
                "app_id": "255",
                "target_id": "0xef0040",
                "initiator_id": "0xef0000",
                "lun": "0000-0000-0000-0000",
                "active_io_read_count": "0",
                "active_io_write_count": "1",
                "total_read_io_count": "0",
                "total_write_io_count": "84701",
                "total_seq_read_io_count": "0",
                "total_seq_write_io_count": "1",
                "total_read_io_time": "0",
                "total_write_io_time": "7007132",
                "total_read_io_initiation_time": "0",
                "total_write_io_initiation_time": "2421756",
                "total_read_io_bytes": "0",
                "total_write_io_bytes": "86733824",
                "total_read_io_inter_gap_time": "0",
                "total_write_io_inter_gap_time": "2508109021",
                "total_time_metric_based_read_io_count": "0",
                "total_time_metric_based_write_io_count": "84701",
                "total_time_metric_based_read_io_bytes": "0",
                "total_time_metric_based_write_io_bytes": "86733824",
                "read_io_rate": "0",
                "peak_read_io_rate": "0",
                "write_io_rate": "8711",
                "peak_write_io_rate": "8711",
                "read_io_bandwidth": "0",
                "peak_read_io_bandwidth": "0",
                "write_io_bandwidth": "8920576",
                "peak_write_io_bandwidth": "8920576",
                "read_io_size_min": "0",
                "read_io_size_max": "0",
                "write_io_size_min": "1024",
                "write_io_size_max": "1024",
                "read_io_completion_time_min": "0",
                "read_io_completion_time_max": "0",
                "write_io_completion_time_min": "74",
                "write_io_completion_time_max": "844",
                "read_io_initiation_time_min": "0",
                "read_io_initiation_time_max": "0",
                "write_io_initiation_time_min": "24",
                "write_io_initiation_time_max": "775",
                "read_io_inter_gap_time_min": "0",
                "read_io_inter_gap_time_max": "0",
                "write_io_inter_gap_time_min": "26903",
                "write_io_inter_gap_time_max": "287888",
                "peak_active_io_read_count": "0",
                "peak_active_io_write_count": "3",
                "read_io_aborts": "0",
                "write_io_aborts": "0",
                "read_io_failures": "0",
                "write_io_failures": "0",
                "read_io_scsi_check_condition_count": "0",
                "write_io_scsi_check_condition_count": "0",
                "read_io_scsi_busy_count": "0",
                "write_io_scsi_busy_count": "0",
                "read_io_scsi_reservation_conflict_count": "0",
                "write_io_scsi_reservation_conflict_count": "0",
                "read_io_scsi_queue_full_count": "0",
                "write_io_scsi_queue_full_count": "0",
                "sampling_start_time": "1530683133",
                "sampling_end_time": "1530684301"
        },
}}

次に、最小、最大、およびピークフローメトリックをすべてクリアした後の出力の例を示します。クリアされたメトリックは出力で強調表示されています。


switch# show analytics query "select all from  fc-scsi.scsi_target_itl_flow where port=fc1/17" clear
{ "values": {
        "1": {
                "port": "fc1/17",
               "vsan": "1",
                "app_id": "255",
                "target_id": "0xef0040",
                "initiator_id": "0xef0000",
                "lun": "0000-0000-0000-0000",
                "active_io_read_count": "0",
                "active_io_write_count": "0",
                "total_read_io_count": "0",
                "total_write_io_count": "800615",
                "total_seq_read_io_count": "0",
                "total_seq_write_io_count": "1",
                "total_read_io_time": "0",
                "total_write_io_time": "66090290",
                "total_read_io_initiation_time": "0",
                "total_write_io_initiation_time": "22793874",
                "total_read_io_bytes": "0",
                "total_write_io_bytes": "819829760",
                "total_read_io_inter_gap_time": "0",
                "total_write_io_inter_gap_time": "23702347887",
                "total_time_metric_based_read_io_count": "0",
                "total_time_metric_based_write_io_count": "800615",
                "total_time_metric_based_read_io_bytes": "0",
                "total_time_metric_based_write_io_bytes": "819829760",
                "read_io_rate": "0",
                "peak_read_io_rate": "0",
                "write_io_rate": "0",
                "peak_write_io_rate": "0",
                "read_io_bandwidth": "0",
                "peak_read_io_bandwidth": "0",
                "write_io_bandwidth": "0",
                "peak_write_io_bandwidth": "0",
                "read_io_size_min": "0",
                "read_io_size_max": "0",
                "write_io_size_min": "0",
                "write_io_size_max": "0",
                "read_io_completion_time_min": "0",
                "read_io_completion_time_max": "0",
                "write_io_completion_time_min": "0",
                "write_io_completion_time_max": "0",
                "read_io_initiation_time_min": "0",
                "read_io_initiation_time_max": "0",
                "write_io_initiation_time_min": "0",
                "write_io_initiation_time_max": "0",
                "read_io_inter_gap_time_min": "0",
                "read_io_inter_gap_time_max": "0",
                "write_io_inter_gap_time_min": "0",
                "write_io_inter_gap_time_max": "0",
                "peak_active_io_read_count": "0",
                "peak_active_io_write_count": "0",
                "read_io_aborts": "0",
                "write_io_aborts": "0",
                "read_io_failures": "0",
                "write_io_failures": "0",
                "read_io_scsi_check_condition_count": "0",
                "write_io_scsi_check_condition_count": "0",
                "read_io_scsi_busy_count": "0",
                "write_io_scsi_busy_count": "0",
                "read_io_scsi_reservation_conflict_count": "0",
                "write_io_scsi_reservation_conflict_count": "0",
                "read_io_scsi_queue_full_count": "0",
                "write_io_scsi_queue_full_count": "0",
                "sampling_start_time": "1530683133",
                "sampling_end_time": "1530684428"
        },
}}

次に、ストリーミングサンプル間隔の間に変更された ITL フローメトリックのみストリーミングする例を示します。

次に、[差分（Differential）] オプションを使用する前の出力の例を示します。


switch# show analytics query "select port, target_id, initiator_id,lun,total_write_io_count from fc-scsi.scsi_target_itl_flow where port=fc1/17" differential 
{ "values": {
        "1": {
                "port": "fc1/17",
                "target_id": "0xef0040",
                "initiator_id": "0xef0000",
                "lun": "0001-0000-0000-0000",
                "total_write_io_count": "1515601",
                "sampling_start_time": "1530683133",
                "sampling_end_time": "1530683484"
        },
        "2": {
                "port": "fc1/17",
                "target_id": "0xef0040",
                "initiator_id": "0xef0020",
                "lun": "0000-0000-0000-0000",
                "total_write_io_count": "1515601",
                "sampling_start_time": "1530683133",
                "sampling_end_time": "1530683484"
        },
        "3": {
                "port": "fc1/17",
                "target_id": "0xef0040",
                "initiator_id": "0xef0020",
                "lun": "0001-0000-0000-0000",
                "total_write_io_count": "1515600",
                "sampling_start_time": "1530683133",
                "sampling_end_time": "1530683484"
        },
        "4": {
                "port": "fc1/17",
                "target_id": "0xef0040",
                "initiator_id": "0xef0000",
                "lun": "0000-0000-0000-0000",
                "total_write_io_count": "1515600",
                "sampling_start_time": "1530683133",
                "sampling_end_time": "1530683484"
        }
}}

次に、[差分（Differential）] オプションを使用した出力、および変更されたレコードのみの出力の例を示します。


switch# show analytics query "select port, target_id, initiator_id,lun,total_write_io_count from fc-scsi.scsi_target_itl_flow where port=fc1/17" differential 
{ "values": {
       "1": {
                "port": "fc1/17",
                "target_id": "0xef0040",
                "initiator_id": "0xef0000",
                "lun": "0001-0000-0000-0000",
                "total_write_io_count": "1892021",
                "sampling_start_time": "1530683133",
                "sampling_end_time": "1530683534"
        },
        "2": {
                "port": "fc1/17",
                "target_id": "0xef0040",
                "initiator_id": "0xef0020",
                "lun": "0000-0000-0000-0000",
                "total_write_io_count": "1892021",
                "sampling_start_time": "1530683133",
                "sampling_end_time": "1530683534"
        },
        "3": {
                "port": "fc1/17",
                "target_id": "0xef0040",
                "initiator_id": "0xef0000",
                "lun": "0000-0000-0000-0000",
                "total_write_io_count": "1892021",
                "sampling_start_time": "1530683133",
                "sampling_end_time": "1530683534"
        }
}}

次に、インストールされたクエリ名を削除する例を示します。


switch(config)# no analytics name initiator_itl_flow

次に、フローメトリックをクリアする例を示します。

次に、フローメトリックをクリアする前の出力の例を示します。


switch# show analytics query "select port,target_id,total_write_io_count,
total_write_io_bytes,total_time_metric_based_write_io_count,write_io_rate,
peak_write_io_rate,write_io_bandwidth,peak_write_io_bandwidth,
write_io_size_min,write_io_size_max,write_io_completion_time_min,
write_io_completion_time_max,write_io_initiation_time_min,
write_io_initiation_time_max,write_io_inter_gap_time_min,write_io_inter_gap_time_max 
from fc-scsi.scsi_target where 
target_id=0x650060" 
{ "values": {
        "1": {
                "port": "fc3/17",
                "target_id": "0x650060",
                "total_write_io_count": "67350021",
                "total_write_io_bytes": "17655403905024",
                "total_time_metric_based_write_io_count": "67349761",
                "write_io_rate": "0",
                "peak_write_io_rate": "6300",
                "write_io_bandwidth": "0",
                "peak_write_io_bandwidth": "1651572736",
                "write_io_size_min": "262144",
                "write_io_size_max": "262144",
                "write_io_completion_time_min": "192",
                "write_io_completion_time_max": "9434",
                "write_io_initiation_time_min": "21",
                "write_io_initiation_time_max": "199",
                "write_io_inter_gap_time_min": "2553",
                "write_io_inter_gap_time_max": "358500",
                "sampling_start_time": "1531204359",
                "sampling_end_time": "1531215327"
        }

次に、フローメトリックをクリアする例を示します。

（注）

メトリックのクリアは、ビューインスタンスでのみ可能で、個々のフローメトリックではできません。


switch# clear analytics query "select all from fc-scsi.scsi_target where target_id=0x650060"

次に、フローメトリックをクリアした後の出力の例を示します。


switch# show analytics query "select port,target_id,total_write_io_count,
total_write_io_bytes,total_time_metric_based_write_io_count,write_io_rate,
peak_write_io_rate,write_io_bandwidth,peak_write_io_bandwidth,
write_io_size_min,write_io_size_max,write_io_completion_time_min,
write_io_completion_time_max,write_io_initiation_time_min,
write_io_initiation_time_max,write_io_inter_gap_time_min,write_io_inter_gap_time_max 
from fc-scsi.scsi_target where target_id=0x650060" 
{ "values": {
        "1": {
                "port": "fc3/17",
                "target_id": "0x650060",
                "total_write_io_count": "0",
                "total_write_io_bytes": "0",
                "total_time_metric_based_write_io_count": "0",
                "write_io_rate": "0",
                "peak_write_io_rate": "0",
                "write_io_bandwidth": "0",
                "peak_write_io_bandwidth": "0",
                "write_io_size_min": "0",
                "write_io_size_max": "0",
                "write_io_completion_time_min": "0",
                "write_io_completion_time_max": "0",
                "write_io_initiation_time_min": "0",
                "write_io_initiation_time_max": "0",
                "write_io_inter_gap_time_min": "0",
                "write_io_inter_gap_time_max": "0",
                "sampling_start_time": "1531204359",
                "sampling_end_time": "1531215464"
        }

次に、フローメトリックを消去した後の出力の例を示します。

（注）

port キー値は、消去メトリックの where 句でのみ使用できます。


switch# purge analytics query "select all from fc-scsi.scsi_target where port=fc3/17"
switch# show analytics query "select all from fc-scsi.scsi_target where port=fc3/17"
Table is empty for query "select all from fc-scsi.scsi_target where port=fc3/17"

ShowAnalytics オーバーレイ CLI の使用

ShowAnalyticsオーバーレイ CLI は、JSON 形式の分析データを使いやすい表形式に変換するために使用されます。ShowAnalyticsオーバーレイ CLI には「Linux と同等」の構文があり、組み込みの NX-OS python インタープリタを使用して、プルクエリの JSON 出力を表形式に変換するスクリプトを実行します。現時点では、フローメトリックの小さなサブセットのみ表示されます。

（注）

ShowAnalyticsオーバーレイ CLI では、Exchange Completion Time (ECT) for the --initiator-itl and --target-itloptions under the --info オプションの累積データが表示されます。ただし、レートおよび帯域幅メトリックについては瞬間的なデータが表示されます。
アクティブな ITL 数が記載されている制限を超えている場合、ShowAnalyticsオーバーレイコマンドは警告を表示して終了します。ITL 数の制限の詳細については、Cisco MDS NX-OS の設定の制限、リリース 8.x [英語] を参照してください。
Virtual Instruments 社や DCNM によって推奨されている clear キーワードを指定してプッシュクエリを設定する場合、最小と最大のフローメトリックの値は不正確になります。

分析情報を表形式で表示するには、次のコマンドを実行します。

switch# ShowAnalytics –help


switch# ShowAnalytics –help
usage: analytics [-h] [--version] [--info] [--errors] [--initiator-itl] [--target-itl] 
[--interface INTERFACE] [--vsan VSAN] [--target TARGET] [--initiator INITIATOR] [--lun LUN] 
analytics optional arguments:
  -h, --help            show this help message and exit
  --version             version
  --info                --info | --errors mandatory
  --errors              --info | --errors mandatory
  --initiator-itl       --initiator-itl | --target-itl mandatory
  --target-itl          --initiator-itl | --target-itl mandatory
  --interface INTERFACE
                        fc interface
  --vsan VSAN           vsan
  --target TARGET       target FCID
  --initiator INITIATOR
                        initiator FCID
  --lun LUN             lun

表 14. 構文の説明
`-h` , `--help`	使用可能なキーワードと引数のリストに関する情報が表示されます。
`--version`	SAN アナリティクスバージョンが表示されます。
`--info`	ビュータイプに固有の情報が表示されます。
`--errors`	ビュータイプに固有のエラーが表示されます。
`--initiator-itl`	initiator-target-LUN フローの SAN アナリティクス情報が表示されます。
`--target-itl`	ターゲット ITL フローの SAN アナリティクス情報が表示されます。
`--interface`	特定のインターフェイスの SAN アナリティクス情報が表示されます。
`--vsan id`	特定の VSAN の SAN アナリティクス情報が表示されます。
`--target id`	特定のターゲットの SAN アナリティクス情報が表示されます。
`--initiator id`	特定のイニシエータの SAN アナリティクス情報が表示されます。
`--lun id`	特定の LUN の SAN アナリティクス情報が表示されます。

例：ShowAnalytics オーバーレイ CLI の使用

次に、オーバーレイ CLI の使用に関する情報を取得する例を示します。


switch# ShowAnalytics –help
usage: analytics [-h] [--version] [--info] [--errors] [--initiator-itl] [--target-itl] 
[--interface INTERFACE] [--vsan VSAN] [--target TARGET] [--initiator INITIATOR] 
[--lun LUN] analytics optional arguments:
  -h, --help            show this help message and exit
  --version             version
  --info                --info | --errors mandatory
  --errors              --info | --errors mandatory
  --initiator-itl       --initiator-itl | --target-itl mandatory
  --target-itl          --initiator-itl | --target-itl mandatory
  --interface INTERFACE
                        fc interface
  --vsan VSAN           vsan
  --target TARGET       target FCID
  --initiator INITIATOR
                        initiator FCID
  --lun LUN             lun

次に、オーバーレイ CLI バージョンの表示例を示します。


switch# ShowAnalytics --version
ShowAnalytics 1.1

次に、イニシエータ ITL のフローメトリックの表示例を示します。


switch# ShowAnalytics --info --initiator-itl
 Interface fc12/15
+-----------------------------------------+----------+---------------+---------------+
| VSAN|I|T|L                              | Avg IOPS |Avg Thput (B/s)| Avg ECT (usec)|
+-----------------------------------------+----------+---------------+---------------+
|                                         |Read|Write| Read|Write    | Read|Write    |
|                                         |          |               |               |
| 4|0x650060|0x650040|0000-0000-0000-0000 | 2355|2311|9646080|9467904| 282|248       |
| 4|0x650060|0x650040|0001-0000-0000-0000 | 2313|2330|9477120|9543680| 282|236       |
| 4|0x650060|0x650040|0002-0000-0000-0000 | 2324|2337|9519104|9574400| 298|236       |
| 4|0x650061|0x650041|0001-0000-0000-0000 | 2335|2294|9567232|9397248| 274|254       |
| 4|0x650061|0x650041|0000-0000-0000-0000 | 2283|2333|9351168|9559040| 284|246       |
| 4|0x650061|0x650041|0002-0000-0000-0000 | 2302|2354|9431040|9645056| 289|252       |
+-----------------------------------------+----------+---------------+---------------+
Interface fc3/15
+-----------------------------------------+----------+----------------+---------------+
| VSAN|I|T|L                              | Avg IOPS |Avg Thput (B/s) | Avg ECT (usec)|
+-----------------------------------------+----------+----------------+---------------+
|                                         |Read|Write| Read|Write     | Read|Write    |
|                                         |          |                |               |
| 1|0x220380|0x2203e0|0001-0000-0000-0000 |2315|2358 | 9482240|9661440| 101|62        |
| 1|0x220380|0x2203e0|0000-0000-0000-0000 |2330|2355 | 9545728|9647104| 102|62        |
| 1|0x220380|0x2203e0|0002-0000-0000-0000 |2334|2335 | 9560064|9567232| 102|61        |
| 1|0x220381|0x2203e2|0001-0000-0000-0000 |2414|2379 | 9888768|9744384| 99|63         |
| 1|0x220381|0x2203e2|0002-0000-0000-0000 |2381|2323 | 9753600|9518080| 101|64        |
| 1|0x220381|0x2203e2|0000-0000-0000-0000 |2315|2354 | 9483264|9643008| 104|64        |
+-----------------------------------------+----------+----------------+---------------+

次に、ターゲット ITL のフローメトリックの表示例を示します。


switch# ShowAnalytics --info --target-itl
Interface fc12/16
+-----------------------------------------+----------+---------------+---------------+
| VSAN|I|T|L                              |Avg IOPS  |Avg Thput (B/s)| Avg ECT (usec)|
+-----------------------------------------+----------+---------------+---------------+
|                                         |Read|Write|Read|Write     | Read|Write    |
|                                         |          |               |               |
| 1|0x220381|0x2203e2|0000-0000-0000-0000 |2334|2308 |9562112|9456640| 135|94        |
| 1|0x220381|0x2203e2|0002-0000-0000-0000 |2339|2375 |9581568|9731072| 137|92        |
| 1|0x220380|0x2203e0|0000-0000-0000-0000 |2353|2299 |9637888|9418752| 135|97        |
| 1|0x220380|0x2203e0|0002-0000-0000-0000 |2303|2363 |9434112|9678848| 136|92        |
| 1|0x220380|0x2203e0|0001-0000-0000-0000 |2315|2335 |9485312|9565184| 137|95        |
| 1|0x220381|0x2203e2|0001-0000-0000-0000 |2311|2375 |9465856|9731072| 135|96        |
+-----------------------------------------+----------+---------------+---------------+

 Interface fc3/16
+-----------------------------------------+----------+---------------+---------------+
| VSAN|I|T|L                              |Avg IOPS  |Avg Thput (B/s)| Avg ECT (usec)|
+-----------------------------------------+----------+---------------+---------------+
|                                         |Read|Write|Read|Write     | Read|Write    |
|                                         |          |               |               |
| 4|0x650060|0x650040|0002-0000-0000-0000 |2299|2367 |9417728|9696256| 247|199       |
| 4|0x650060|0x650040|0000-0000-0000-0000 |2353|2310 |9637888|9462784| 250|204       |
| 4|0x650060|0x650040|0001-0000-0000-0000 |2320|2326 |9503744|9529344| 247|209       |
| 4|0x650061|0x650041|0002-0000-0000-0000 |2327|2320 |9532416|9504768| 236|205       |
| 4|0x650061|0x650041|0000-0000-0000-0000 |2322|2318 |9513984|9494528| 244|209       |
| 4|0x650061|0x650041|0001-0000-0000-0000 |2311|2333 |9467904|9559040| 257|198       |
+-----------------------------------------+----------+-----------------+-------------+

次に、イニシエータ ITL の VSAN 1 のフローメトリックの表示例を示します。


switch# ShowAnalytics --info --initiator-itl --vsan 1
 Interface fc3/15
+-----------------------------------------+----------+---------------+---------------+
| VSAN|I|T|L                              |Avg IOPS  |Avg Thput (B/s)| Avg ECT (usec)|
+-----------------------------------------+----------+---------------+---------------+
|                                         |Read|Write|Read|Write     | Read|Write    |
|                                         |          |               |               |
| 1|0x220380|0x2203e0|0001-0000-0000-0000 |2317|2324 |9491456|9521152| 106|68        |
| 1|0x220380|0x2203e0|0000-0000-0000-0000 |2337|2300 |9573376|9420800| 107|68        |
| 1|0x220380|0x2203e0|0002-0000-0000-0000 |2331|2317 |9547776|9491456| 107|66        |
| 1|0x220381|0x2203e2|0001-0000-0000-0000 |2316|2331 |9487360|9547776| 104|69        |
| 1|0x220381|0x2203e2|0002-0000-0000-0000 |2316|2332 |9486336|9553920| 106|69        |
| 1|0x220381|0x2203e2|0000-0000-0000-0000 |2313|2298 |9474048|9412608| 109|69        |
+-----------------------------------------+----------+---------------+---------------+

次に、ターゲット ITL のインターフェイス fc12/19 のフローメトリックの表示例を示します。


switch# ShowAnalytics --info --target-itl --interface fc12/19
 Interface fc12/19
+-----------------------------------------+----------+---------------+---------------+
| VSAN|I|T|L                              |Avg IOPS  |Avg Thput (B/s)| Avg ECT (usec)|
+-----------------------------------------+----------+---------------+---------------+
|                                         |Read|Write|Read|Write     | Read|Write    |
|                                         |          |               |               |
| 4|0x650020|0x650000|0000-0000-0000-0000 |0|7486    |0|15331840     | 0|211         |
+-----------------------------------------+----------+---------------+---------------+

次に、ターゲット ITL のターゲット ID 0x2203e2 のフローメトリックの表示例を示します。


switch# ShowAnalytics --info --target-itl --target 0x2203e2 
 Interface fc12/16
+-----------------------------------------+----------+---------------+---------------+
| VSAN|I|T|L                              |Avg IOPS  |Avg Thput (B/s)| Avg ECT (usec)|
+-----------------------------------------+----------+---------------+---------------+
|                                         |Read|Write|Read|Write     | Read|Write    |
|                                         |          |               |               |
| 1|0x220381|0x2203e2|0000-0000-0000-0000 |2323|2301 |9518080|9427968| 145|105       |
| 1|0x220381|0x2203e2|0002-0000-0000-0000 |2293|2343 |9395200|9597952| 148|102       |
| 1|0x220381|0x2203e2|0001-0000-0000-0000 |2282|2341 |9349120|9591808| 145|106       |
+-----------------------------------------+----------+---------------+---------------+

次に、イニシエータ ITL のイニシエータ ID 0xbc0919、ターゲット ID 0xbc092f、および LUN ID 0008-0000-0000-0000 のフローメトリックの表示例を示します。


switch# ShowAnalytics --info --initiator-itl --initiator 0xbc0a2e --target 0xbc0a65 --lun 0008-0000-0000-0000
2018-12-11 20:17:52.898297
 
B: Bytes, s: Seconds, Avg: Average, Acc: Accumulative,
ns: Nano Seconds, ms: Milli Seconds, us: Micro Seconds,
GB: Giga Bytes, MB: Mega Bytes, KB: Killo Bytes,
ECT: Exchange Completion Time, DAL: Data Access Latency
 
 
Interface : fc1/16
+-------------------------------+----------+----------+----------+
| Metric                        |    Min   |    Max   |    Avg   |
+-------------------------------+----------+----------+----------+
| Read  IOPS         (4sec Avg) |       NA |       NA |       20 |
| Write IOPS         (4sec Avg) |       NA |       NA |       21 |
| Read  Throughput   (4sec Avg) |       NA |       NA |   2 MB/s |
| Write Throughput   (4sec Avg) |       NA |       NA |   2 MB/s |
| Read  Size         (Acc Avg)  | 130048 B | 130048 B | 130048 B |
| Write Size         (Acc Avg)  | 130048 B | 130048 B | 130048 B |
| Read  DAL          (Acc Avg)  |    31 us |     9 ms |   698 us |
| Write DAL          (Acc Avg)  |    21 us |     6 ms |    58 us |
| Read  ECT          (Acc Avg)  |   111 us |   167 ms |     1 ms |
| Write ECT          (Acc Avg)  |    89 us |     7 ms |   315 us |
| Read  Inter-IO-Gap (Acc Avg)  |   109 ns |   769 ms |    31 ms |
| Write Inter-IO-Gap (Acc Avg)  |   664 ns |   686 ms |    31 ms |
+-------------------------------+----------+----------+----------+

フローメトリックの詳細については、フローメトリックを参照してください。

次に、ターゲット ITL のイニシエータ ID 0x220381 と LUN ID0002-0000-0000-0000 のフローメトリックの表示例を示します。


switch# ShowAnalytics --info --target-itl --initiator 0x220381 --lun 0002-0000-0000-0000 
Interface fc12/16
+-----------------------------------------+----------+---------------+---------------+
| VSAN|I|T|L                              |Avg IOPS  |Avg Thput (B/s)| Avg ECT (usec)|
+-----------------------------------------+----------+---------------+---------------+
|                                         |Read|Write|Read|Write     | Read|Write    |
|                                         |          |               |               |
| 1|0x220381|0x2203e2|0002-0000-0000-0000 |2319|2340 |9500672|9585664| 150|104       |
+-----------------------------------------+----------+---------------+---------------+

次に、イニシエータ ITL のインターフェイス fc12/21 のエラーの表示例を示します。


switch# ShowAnalytics --errors --initiator-itl --interface fc12/21 
Interface fc12/21
+-----------------------------------------+---------------------+-----------------+
| VSAN|I|T|L                              | Total SCSI Failures | Total FC Aborts |
+-----------------------------------------+---------------------+-----------------+
|                                         | Read|Write          | Read|Write      |
|                                         |                     |                 |
| 4|0x650020|0x650000|0000-0000-0000-0000 | 0|0                 | 0|18            |
+-----------------------------------------+---------------------+-----------------+

フローごとの輻輳ドロップの表示

SAN アナリティクス機能では、フローごとのパケットタイムアウトドロップ数が表示されます。ポートのタイムスタンプとともにドロップされたパケットの数が表示されます。

フローごとのパケットドロップ数を表示するには、次のコマンドを実行します。

switch# show analytics type fc-scsi flow congestion-drops

例：フローごとの輻輳ドロップの表示

次に、ネットワークの輻輳が原因でタイムアウトドロップが発生したインターフェイスの例を示します。


switch# show analytics type fc-scsi flow congestion-drops

|=====================================================================================|
| Source       |Destination            | Congestion    |     Timestamp                |
| INTF  | VSAN |  FCID     |  FCID     | Drops(delta)  |                              |
|=====================================================================================|
| fc2/13| 0002 | 0x9900E1  | 0x640000  |  00000105     | 1. 09/13/17 11:09:48.762     |
| fc2/13| 0002 | 0x9900E1  | 0x640000  |  00000002     | 2. 09/13/17 09:05:39.527     |
| fc2/13| 0002 | 0x990000  | 0x640020  |  00000002     | 3. 09/13/17 09:05:39.527     |
|=====================================================================================|
| fc2/31| 0002 | 0x640000  | 0x9900E1  |  00000084     | 1. 09/12/17 08:17:11.905     |
| fc2/31| 0002 | 0x640000  | 0x9900E1  |  00000076     | 2. 09/12/17 05:50:37.721     |
| fc2/31| 0002 | 0x640000  | 0x9900E1  |  00000067     | 3. 09/12/17 03:24:03.319     |
| fc2/31| 0002 | 0x640000  | 0x9900E1  |  00000088     | 4. 09/12/17 00:57:28.019     |
| fc2/31| 0002 | 0x640000  | 0x9900E1  |  00000088     | 5. 09/11/17 22:30:53.723     |
| fc2/31| 0002 | 0x640000  | 0x9900E1  |  00000086     | 6. 09/11/17 20:04:18.001     |
| fc2/31| 0002 | 0x640000  | 0x9900E1  |  00000026     | 7. 09/11/17 17:37:24.273     |
| fc2/31| 0002 | 0x640000  | 0x9900E1  |  00000076     | 8. 09/11/17 15:10:50.240     |
| fc2/31| 0002 | 0x640000  | 0x9900E1  |  00000074     | 9. 09/11/17 12:44:15.866     |
| fc2/31| 0002 | 0x640000  | 0x9900E1  |  00000087     |10. 09/11/17 10:17:41.402     |
| fc2/31| 0002 | 0x640000  | 0x9900E1  |  00000086     |11. 09/11/17 07:51:10.412     |
| fc2/31| 0002 | 0x640000  | 0x9900E1  |  00000084     |12. 09/11/17 05:24:35.981     |
| fc2/31| 0002 | 0x640000  | 0x9900E1  |  00000083     |13. 09/11/17 02:58:01.067     |
| fc2/31| 0002 | 0x640000  | 0x9900E1  |  00000086     |14. 09/11/17 00:31:26.709     |
| fc2/31| 0002 | 0x640000  | 0x9900E1  |  00000079     |15. 09/10/17 22:04:51.399     |
| fc2/31| 0002 | 0x640000  | 0x9900E1  |  00000084     |16. 09/10/17 19:38:17.217     |
| fc2/31| 0002 | 0x640000  | 0x9900E1  |  00000082     |17. 09/10/17 17:11:42.594     |
| fc2/31| 0002 | 0x640000  | 0x9900E1  |  00000086     |18. 09/10/17 14:44:52.786     |
| fc2/31| 0002 | 0x640000  | 0x9900E1  |  00000089     |19. 09/10/17 12:18:18.394     |
| fc2/31| 0002 | 0x640000  | 0x9900E1  |  00000087     |20. 09/10/17 09:51:44.067     |
|=====================================================================================|

SAN アナリティクスの確認

次に、SAN アナリティクス機能が有効になっているインターフェイスのリストの例を示します。


switch# show running-config analytics 
!Command: show running-config analytics
!Running configuration last done at: Fri Jun 29 09:03:09 2018
!Time: Fri Jun 29 13:00:41 2018

version 8.3(1)
feature analytics

analytics query "Select all from fc-scsi.port" name port type periodic interval 30
analytics query "Select all from fc-scsi.port where port=fc1/1" name portfc1_1 type periodic interval 30  differential
analytics query "Select all from fc-scsi.port where port=fc1/32" name portfc1_32 type periodic interval 30  differential
analytics query "select port, vsan, app_id, initiator_id, target_id, lun, active_io_read_count, active_io_write_count, total_read_io_count, total_write_io_count, total_time_metric_
based_read_io_count, total_time_metric_based_write_io_count,total_read_io_time, total_write_io_time, total_read_io_initiation_time, total_write_io_initiation_time,total_read_io_byt
es, total_write_io_bytes, total_time_metric_based_read_io_bytes, total_time_metric_based_write_io_bytes, read_io_rate, write_io_rate, read_io_bandwidth, write_io_bandwidth,read_io_
size_min, read_io_size_max, write_io_size_min, write_io_size_max,read_io_completion_time_min, read_io_completion_time_max, write_io_completion_time_min, write_io_completion_time_ma
x,read_io_initiation_time_max, write_io_initiation_time_max, read_io_aborts, write_io_aborts,read_io_failures, write_io_failures, from fc-scsi.s
csi_initiator_itl_flow" name dcnminitITL type periodic interval 30

interface fc1/2
  analytics type fc-scsi

interface fc1/4
  analytics type fc-scsi

interface fc1/6
  analytics type fc-scsi

interface fc1/7
  analytics type fc-scsi

interface fc1/8
  analytics type fc-scsi

interface fc1/9
  analytics type fc-scsi

interface fc1/10
  analytics type fc-scsi

interface fc1/11
  analytics type fc-scsi

次に、スイッチにインストールされている設定済みのプッシュクエリのリストの例を示します。


switch(config)# show analytics query all
Total queries:7
============================
Query Name      :init
Query String    :select all from fc-scsi.scsi_initiator
Query Type      :periodic, interval 30

Query Name      :targettl
Query String    :select all from fc-scsi.scsi_target_tl_flow
Query Type      :periodic, interval 30
Query Options   :differential clear

Query Name      :port
Query String    :select all from fc-scsi.logical_port
Query Type      :periodic, interval 30

Query Name      :targetit
Query String    :select all from fc-scsi.scsi_target_it_flow
Query Type      :periodic, interval 30

Query Name      :targetitl
Query String    :select all from fc-scsi.scsi_target_itl_flow
Query Type      :periodic, interval 30
Query Options   :differential clear

Query Name      :inititl
Query String    :select all from fc-scsi.scsi_initiator_itl_flow
Query Type      :periodic, interval 30

Query Name      :initit
Query String    :select all from fc-scsi.scsi_initiator_it_flow
Query Type      :periodic, interval 30

次に、モジュールごとの NPU の負荷と ITL 数を表示する例を示します。


switch# show analytics system-load
Analytics System Load Info
------------------------------------------------
| Module | NPU Load | ITLs | Hosts | Targets |
------------------------------------------------
| 1      | 100%     | 20037| 0     | 200     |
------------------------------------------------
| 3      | 100%     | 8706 | 0     | 177     |
------------------------------------------------
| 4      | 100%     | 20803| 0     | 351     |
------------------------------------------------
| 5      | 100%     | 16482| 0     | 168     |
------------------------------------------------
| 8      | 77%      | 21080| 0     | 195     |
------------------------------------------------
| 12      | 5%      | 16200| 0     | 100     |
------------------------------------------------
| 13      | 70%     | 440  | 0     | 100     |
------------------------------------------------
| 18      | 100%    | 9347 | 0     | 190     |
------------------------------------------------
| Total   |         |113095|       |         |
------------------------------------------------
As of Fri Nov 16 06:03:26 2018

次に、ポートサンプリングステータスと瞬間的な NPU の負荷を確認する例を示します。

（注）

ポートの横にあるアスタリスク記号（*）は、そのポートが現在サンプリングされていることを示しています。


switch# show analytics port-sampling module 1
Sampling Window Size: 1
Rotation Interval: 30
NPU Load: 0%
========================================================================
  Port               Monitored Start Time           Monitored End Time
========================================================================
  fc1/4              07/09/18 - 08:33:20            07/09/18 - 08:33:50    
  fc1/6              07/09/18 - 08:33:50            07/09/18 - 08:34:20    
  fc1/7              07/09/18 - 08:34:20            07/09/18 - 08:34:50    
  fc1/8              07/09/18 - 08:34:50            07/09/18 - 08:35:20    
  fc1/10             07/09/18 - 08:35:20            07/09/18 - 08:35:50    
  fc1/11             07/09/18 - 08:35:50            07/09/18 - 08:36:20    
  fc1/12             07/09/18 - 08:36:20            07/09/18 - 08:36:50    
  fc1/14             07/09/18 - 08:36:50            07/09/18 - 08:37:20    
  fc1/15             07/09/18 - 08:37:20            07/09/18 - 08:37:50    
  fc1/16             07/09/18 - 08:37:50            07/09/18 - 08:38:20    
  fc1/18*            07/09/18 - 08:38:20            -                      
  fc1/20             07/09/18 - 08:28:50            07/09/18 - 08:29:20    
  fc1/22             07/09/18 - 08:29:20            07/09/18 - 08:29:50    
  fc1/23             07/09/18 - 08:29:50            07/09/18 - 08:30:20    
  fc1/24             07/09/18 - 08:30:20            07/09/18 - 08:30:50    
  fc1/26             07/09/18 - 08:30:50            07/09/18 - 08:31:20    
  fc1/27             07/09/18 - 08:31:20            07/09/18 - 08:31:50    
  fc1/28             07/09/18 - 08:31:50            07/09/18 - 08:32:20    
  fc1/30             07/09/18 - 08:32:20            07/09/18 - 08:32:50    
  fc1/32             07/09/18 - 08:32:50            07/09/18 - 08:33:20

次に、すでに設定されているプッシュクエリの出力の例を示します。


switch# show analytics query name iniitl result 
{ "values": {
        "1": {
                "port": "fc1/6",
                "vsan": "10",
                "app_id": "255",
                "initiator_id": "0xe800a0",
                "target_id": "0xd601e0",
                "lun": "0000-0000-0000-0000",
                "active_io_read_count": "0",
                "active_io_write_count": "7",
                "total_read_io_count": "0",
                "total_write_io_count": "1008608573",
                "total_seq_read_io_count": "0",
                "total_seq_write_io_count": "1",
                "total_read_io_time": "0",
                "total_write_io_time": "370765952314",
                "total_read_io_initiation_time": "0",
                "total_write_io_initiation_time": "52084968152",
                "total_read_io_bytes": "0",
                "total_write_io_bytes": "2065630357504",
                "total_read_io_inter_gap_time": "0",
                "total_write_io_inter_gap_time": "16171468343166",
                "total_time_metric_based_read_io_count": "0",
                "total_time_metric_based_write_io_count": "1008608566",
                "total_time_metric_based_read_io_bytes": "0",
                "total_time_metric_based_write_io_bytes": "2065630343168",
                "read_io_rate": "0",
                "peak_read_io_rate": "0",
                "write_io_rate": "16070",
                "peak_write_io_rate": "32468",
                "read_io_bandwidth": "0",
                "peak_read_io_bandwidth": "0",
                "write_io_bandwidth": "32912384",
                "peak_write_io_bandwidth": "66494976",
                "read_io_size_min": "0",
                "read_io_size_max": "0",
                "write_io_size_min": "2048",
                "write_io_size_max": "2048",
                "read_io_completion_time_min": "0",
                "read_io_completion_time_max": "0",
                "write_io_completion_time_min": "111",
                "write_io_completion_time_max": "9166",
                "read_io_initiation_time_min": "0",
                "read_io_initiation_time_max": "0",
                "write_io_initiation_time_min": "36",
                "write_io_initiation_time_max": "3265",
                "read_io_inter_gap_time_min": "0",
                "read_io_inter_gap_time_max": "0",
                "write_io_inter_gap_time_min": "100",
                "write_io_inter_gap_time_max": "1094718",
                "peak_active_io_read_count": "0",
                "peak_active_io_write_count": "23",
                "read_io_aborts": "0",
                "write_io_aborts": "0",
                "read_io_failures": "0",
                "write_io_failures": "0",
                "read_io_scsi_check_condition_count": "0",
                "write_io_scsi_check_condition_count": "0",
                "read_io_scsi_busy_count": "0",
                "write_io_scsi_busy_count": "0",
                "read_io_scsi_reservation_conflict_count": "0",
                "write_io_scsi_reservation_conflict_count": "0",
                "read_io_scsi_queue_full_count": "0",
                "write_io_scsi_queue_full_count": "0",
                "sampling_start_time": "1529993232",
                "sampling_end_time": "1529993260"
        },
        "2": {
                "port": "fc1/6",
                "vsan": "10",
                "app_id": "255",
                "initiator_id": "0xe800a1",
                "target_id": "0xd601e1",
                "lun": "0000-0000-0000-0000",
                "active_io_read_count": "0",
                "active_io_write_count": "8",
                "total_read_io_count": "0",
                "total_write_io_count": "1004271260",
                "total_seq_read_io_count": "0",
                "total_seq_write_io_count": "1",
                "total_read_io_time": "0",
                "total_write_io_time": "370004164726",
                "total_read_io_initiation_time": "0",
                "total_write_io_initiation_time": "51858511487",
                "total_read_io_bytes": "0",
                "total_write_io_bytes": "2056747540480",
                "total_read_io_inter_gap_time": "0",
                "total_write_io_inter_gap_time": "16136686881766",
                "total_time_metric_based_read_io_count": "0",
                "total_time_metric_based_write_io_count": "1004271252",
                "total_time_metric_based_read_io_bytes": "0",
                "total_time_metric_based_write_io_bytes": "2056747524096",
                "read_io_rate": "0",
                "peak_read_io_rate": "0",
                "write_io_rate": "16065",
                "peak_write_io_rate": "16194",
                "read_io_bandwidth": "0",
                "peak_read_io_bandwidth": "0",
                "write_io_bandwidth": "32901632",
                "peak_write_io_bandwidth": "33165824",
                "read_io_size_min": "0",
                "read_io_size_max": "0",
                "write_io_size_min": "2048",
                "write_io_size_max": "2048",
                "read_io_completion_time_min": "0",
                "read_io_completion_time_max": "0",
                "write_io_completion_time_min": "114",
                "write_io_completion_time_max": "9019",
                "read_io_initiation_time_min": "0",
                "read_io_initiation_time_max": "0",
                "write_io_initiation_time_min": "37",
                "write_io_initiation_time_max": "3158",
                "read_io_inter_gap_time_min": "0",
                "read_io_inter_gap_time_max": "0",
                "write_io_inter_gap_time_min": "101",
                "write_io_inter_gap_time_max": "869035",
                "peak_active_io_read_count": "0",
                "peak_active_io_write_count": "19",
                "read_io_aborts": "0",
                "write_io_aborts": "0",
                "read_io_failures": "0",
                "write_io_failures": "0",
                "read_io_scsi_check_condition_count": "0",
                "write_io_scsi_check_condition_count": "0",
                "read_io_scsi_busy_count": "0",
                "write_io_scsi_busy_count": "0",
                "read_io_scsi_reservation_conflict_count": "0",
                "write_io_scsi_reservation_conflict_count": "0",
                "read_io_scsi_queue_full_count": "0",
                "write_io_scsi_queue_full_count": "0",
                "sampling_start_time": "1529993232",
                "sampling_end_time": "1529993260"
        }
}}

（注）

これらのクエリの出力は JSON 形式です。

Cisco MDS 9000 シリーズ リリース 8.x SAN アナリティクス/SAN テレメトリ ストリーミング コンフィギュレーション ガイド

偏向のない言語

翻訳について

検索結果

章のタイトル： SAN アナリティクスの設定

SAN アナリティクスの設定

SAN アナリティクスの設定の機能履歴

SAN アナリティクスの概要

SAN アナリティクスのハードウェア要件

SAN アナリティクスの注意事項と制約事項

コマンドの変更点

SAN アナリティクスについて

ポート サンプリング

展開モード

オンボード クエリ

メトリックのクエリ用のスキーマ

クエリ構文

クエリ セマンティック ルール

ビュー

サポートされているビュー タイプの一覧

ビュー タイプの表示

例：クエリ構文の設定

SAN アナリティクスの設定

SAN アナリティクスの有効化

手順

SAN アナリティクスの無効化

手順

インターフェイスでの SAN アナリティクスの有効化

始める前に

手順

インターフェイスでの SAN アナリティクスの無効化

始める前に

手順

ポート サンプリングの有効化

手順

ポート サンプリングの無効化

手順

例：SAN アナリティクスの設定

クエリの作成と使用

インストールされているプッシュ クエリの表示

プッシュ クエリの結果の表示

プル クエリの実行

プッシュ クエリの設定

手順

設定されているプッシュ クエリの削除

手順

メトリックのクリア

ビューの消去

設定されているプッシュ クエリの結果の表示

例：クエリの作成と使用

ShowAnalytics オーバーレイ CLI の使用

例：ShowAnalytics オーバーレイ CLI の使用

フローごとの輻輳ドロップの表示

例：フローごとの輻輳ドロップの表示

SAN アナリティクスの確認

このドキュメントは役に立ちましたか?

シスコに問い合わせ

Cisco MDS 9000 シリーズリリース 8.x SAN アナリティクス/SAN テレメトリストリーミングコンフィギュレーションガイド

ポートサンプリング

オンボードクエリ

クエリセマンティックルール

サポートされているビュータイプの一覧

ビュータイプの表示

ポートサンプリングの有効化

ポートサンプリングの無効化

インストールされているプッシュクエリの表示

プッシュクエリの結果の表示

プルクエリの実行

プッシュクエリの設定

設定されているプッシュクエリの削除

設定されているプッシュクエリの結果の表示