この製品のマニュアルセットは、偏向のない言語を使用するように配慮されています。このマニュアルセットでの偏向のない言語とは、年齢、障害、性別、人種的アイデンティティ、民族的アイデンティティ、性的指向、社会経済的地位、およびインターセクショナリティに基づく差別を意味しない言語として定義されています。製品ソフトウェアのユーザーインターフェイスにハードコードされている言語、RFP のドキュメントに基づいて使用されている言語、または参照されているサードパーティ製品で使用されている言語によりドキュメントに例外が存在する場合があります。シスコのインクルーシブランゲージに対する取り組みの詳細は、こちらをご覧ください。
このドキュメントは、米国シスコ発行ドキュメントの参考和訳です。リンク情報につきましては、日本語版掲載時点で、英語版にアップデートがあり、リンク先のページが移動/変更されている場合がありますことをご了承ください。あくまでも参考和訳となりますので、正式な内容については米国サイトのドキュメントを参照ください。
ACI ファブリックでは、1 つ以上のロギング サーバ グループは 1 つ以上のロギング宛先サーバで設定できます。
この例では、syslog 宛先サーバ グループを設定する方法を示します。
apic1# configure apic1(config)# logging server-group myLoggingGroup apic1(config-logging)# logging description "This is my logging server group" apic1(config-logging)# console severity critical apic1(config-logging)# logfile severity critical apic1(config-logging)# server reach.example.com level local4 mgmtepg inb port 514
ロギング宛先としてこのロギング サーバ グループを使用して syslog を設定します。
システム ログ メッセージを受信してモニタするためには、syslog 宛先(コンソール、ローカル ファイル、または syslog サーバを実行している 1 つ以上のリモート ホスト)を指定する必要があります。また、コンソールに表示されるか、ファイルまたはホストによってキャプチャされるメッセージの重大度の最小値を指定できます。
syslog メッセージの送信先サーバを含むロギング サーバグループを設定します。
次に、「通知」以上の重大度のメッセージに syslog を設定する例を示します。障害およびイベント ログからの syslog メッセージは、サーバグループ myLoggingGroup のサーバに送信されます。
apic1# configure apic1(config)# syslog common apic1(config-syslog)# logging description "This is the common logging policy" apic1(config-syslog)# logging severity notifications apic1(config-syslog)# logging server-group myLoggingGroup apic1(config-syslog)# logging audit apic1(config-syslog)# logging event
ACI ファブリックでは、Cisco Call Home 設定を共通のモニタリング ポリシーに追加できます。
次に、基本的な Call Home ポリシーを設定する例を示します。
apic1# configure apic1(config)# callhome common apic1(config-callhome)# logging event apic1(config-callhome)# logging fault apic1(config-callhome)# logging severity notice apic1(config-callhome)# periodic-inventory notification schedule EveryEightHours apic1(config-callhome)# end apic1# show callhome common Callhome : common Logging Enabled : event,faults Logging Severity : notice Destination-Profile : Admin State : Enabled Contract-id : 12345678 Customer-id : ABCDEFG Email-addr : admin@example.com From email-addr : apic1@example.com Reply-To email-addr : apic1@example.com Phone Number : +14085551212 SMTP Port num : 25 SMTP Server : smtp.example.com Destination Email-addr Format Message-Size Message-Level ----------- ----------------- ------ ------------ ------------- SanJose admin@example.com xml 40000 alert Query-Profile : Query Name Query Type Dn/Class Target Respones Subtree Response Include ----------- ---------- -------- ------ ---------------- ------------------------------ myUserQuery class User self children ep-records,fault-records,stats
宛先プロファイルと(オプションで)クエリ プロファイルを設定します。
少なくとも 1 つの Call Home の宛先プロファイルを設定する必要があります。宛先プロファイルが電子メール メッセージ送信を使用している場合、シンプル メール転送プロトコル(SMTP)サーバを指定する必要があります。
| コマンドまたはアクション | 目的 | |||
|---|---|---|---|---|
| ステップ 1 | configure 例: apic1# configure |
グローバル コンフィギュレーション モードを開始します。 |
||
| ステップ 2 | callhomecommon 例: apic1(config)# callhome common |
Call Home 共通ポリシー コンフィギュレーション モードを開始します。 |
||
| ステップ 3 | [no]destination-profile 例: apic1(config-callhome)# destination-profile |
宛先プロファイルを設定します。 |
||
| ステップ 4 | [no]destinationdest-name 例: apic1(config-callhome-destnprof)# destination SanJose |
送信するためのメッセージと重大度のレベルの形式を含む、Call Home メッセージが送信される宛先を設定します。
|
||
| ステップ 5 | [no]email-addremail 例: apic1(config-callhome-destnprof-destn)# email-addr alerts@example.com |
Call Home メッセージを受信する電子メール アドレスを設定します。最大 255 文字の英数字を E メール アドレス フォーマットで指定できます。 |
||
| ステップ 6 | [no]format {aml | xml | short-txt} 例: apic1(config-callhome-destnprof-destn)# format xml |
次の形式で送信可能な Call Home メッセージの形式を設定します。 |
||
| ステップ 7 | [no]message-level {alert | critical | debug | emergency | error | info | notice | warning} 例: apic1(config-callhome-destnprof-destn)# message-level alert |
メッセージを送信するための最小の重大度レベルを設定します。 |
||
| ステップ 8 | [no]message-sizesize 例: apic1(config-callhome-destnprof-destn)# message-size 40000 |
メッセージのサイズを設定します。範囲は 0 ~ 5000000 文字です。 |
||
| ステップ 9 | exit 例: apic1(config-callhome-destnprof-destn)# exit |
宛先プロファイル コンフィギュレーション モードに戻ります。 |
||
| ステップ 10 | 宛先プロファイルを設定します。 例: apic1(config-callhome-destnprof)# (various commands) |
次で説明されているのコマンドを使用します。 Call Home 宛先プロファイル設定コマンド |
||
| ステップ 11 | showcallhomecommon [destination-profile | query-profile | transport-email] 例: apic1(config-callhome-destnprof)# show callhome common transport-email |
Call Home の設定を示します。 |
この例では、alerts@example.com に重大度「alert」またはそれ以上の電子メール メッセージを送信するために、Call Home を設定する方法を示します。
apic1# configure apic1(config)# callhome common apic1(config-callhome)# destination-profile apic1(config-callhome-destnprof)# destination SanJose apic1(config-callhome-destnprof-destn)# email-addr alerts@example.com apic1(config-callhome-destnprof-destn)# format xml apic1(config-callhome-destnprof-destn)# message-level alert apic1(config-callhome-destnprof-destn)# message-size 40000 apic1(config-callhome-destnprof-destn)# exit apic1(config-callhome-destnprof)# contract-id 12345678 apic1(config-callhome-destnprof)# customer-id ABCDEFG apic1(config-callhome-destnprof)# description "Example Corporation" apic1(config-callhome-destnprof)# site-id XYZ123 apic1(config-callhome-destnprof)# street-address "1 Cisco Way" apic1(config-callhome-destnprof)# phone-contact +14085551212 apic1(config-callhome-destnprof)# email-contact admin@example.com apic1(config-callhome-destnprof)# transport email from apic1@example.com apic1(config-callhome-destnprof)# transport email reply-to apic1@example.com apic1(config-callhome-destnprof)# transport email mail-server smtp.example.com mgmtepg inb port 25 apic1(config-callhome)# end apic1# show callhome common transport-email From email-addr : apic1@example.com SMTP Port num : 25 SMTP Server : smtp.example.com
これらのコマンドは、Call Home 宛先プロファイル(config-callhome-destnprof)コンフィギュレーション モードで入力します。
| コマンド |
目的 |
| contract-idcontract-id |
お客様の Call Home 契約番号。 |
| customer-idcustomer-id |
ライセンス上のサポート契約の契約番号を含む Cisco Connection Online(CCO)ID。 |
| descriptiontext |
このお客様サイトに関する説明テキスト。 |
| email-contactemail |
主要連絡先の電子メール アドレス。 |
| phone-contactphone-num |
主要連絡先の電話番号。 |
| site-idsite-id |
お客様のサイトに固有の Call Home ID。 |
| street-addressaddress |
主要連絡先の住所。 |
| transportemailfromemail |
システムによって送信される Call Home アラート メッセージの [From] フィールドに表示される電子メール アドレス。 |
| transportemailreply-toemail |
システムによって送信される Call Home アラート メッセージの [From] フィールドに表示される返信電子メール アドレス。 |
| transportemailmail-serversmtp-servermgmtepg {inb | oob} portport-number |
SMTP サーバの IP アドレスまたはホスト名およびシステムが SMTP サーバへの通信に使用するポート番号。 |
イベントが、Call Home レポートの送信をトリガーすると、選択したクエリの情報がレポートに含まれます。クラス名または識別名に基づいてクエリを設定することができ、さらにサブツリーに基づいてクエリを設定できます。
| コマンドまたはアクション | 目的 | |
|---|---|---|
| ステップ 1 | configure 例: apic1# configure |
グローバル コンフィギュレーション モードを開始します。 |
| ステップ 2 | callhomecommon 例: apic1(config)# callhome common |
Call Home 共通ポリシー コンフィギュレーション モードを開始します。 |
| ステップ 3 | [no]query-profile 例: apic1(config-callhome)# query-profile |
Call Home クエリ プロファイル コンフィギュレーション モードを開始します。 |
| ステップ 4 | [no]queryquery-nametype {classclass-name | dnname} 例: apic1(config-callhome-queryprof)# query myUserQuery type class User |
クエリ プロファイルを設定します。 |
| ステップ 5 | [no]response-subtree {full | children | no} 例: apic1(config-callhome-queryprof-query)# response-subtree children |
応答サブツリーを設定します。完全なサブツリー、1 つの子、またはサブツリー情報を含めることができます。 |
| ステップ 6 | [no]response-incl {option[,option[,option...]]} 例: apic1(config-callhome-queryprof-query)# response-incl ep-records,fault-records,stats |
応答に含まれる特定のサブツリー情報カテゴリを設定します。複数のカテゴリはカンマ区切りのリストで指定できます。使用できるドライブをクエリ サブツリー カテゴリ に示します。 |
| ステップ 7 | [no]target {children | self | subtree} 例: apic1(config-callhome-queryprof-query)# target self |
クエリのターゲットを設定します |
| ステップ 8 | showcallhomecommon [destination-profile | query-profile | transport-email] 例: apic1(config-callhome-queryprof-query)# show callhome common query-profile |
Call Home の設定を示します。 |
この例では、Call Home クエリを設定する方法を示します。
apic1# configure apic1(config)# callhome common apic1(config-callhome)# query-profile apic1(config-callhome-queryprof)# query myUserQuery type class User apic1(config-callhome-queryprof-query)# response-subtree children apic1(config-callhome-queryprof-query)# response-incl ep-records,fault-records,stats apic1(config-callhome-queryprof-query)# target self apic1(config-callhome)# end apic1# show callhome common destination-profile Query-Profile : Query Name Query Type Dn/Class Target Respones Subtree Response Include ----------- ---------- -------- ------ ---------------- ------------------------------ myUserQuery class User self children ep-records,fault-records,stats
| クエリのカテゴリ |
説明 |
| add-mo-list |
|
| audit-logs |
|
| config-only |
|
| count |
|
| custom-path-hop |
|
| deployment |
|
| deployment-records |
|
| ep-records |
|
| event-logs |
|
| fault-count |
|
| fault-records |
|
| faults |
|
| full-deployment |
|
| health |
|
| health-records |
|
| local-prefix |
|
| no-scoped |
|
| none |
|
| port-deployment |
|
| record-subtree |
|
| relations |
|
| relations-with-parent |
|
| required |
|
| state |
|
| stats |
|
| tasks |
|
![]() (注) |
APIC にエクスポートする場合や、帯域幅と計算のリソースが不足している外部サーバにエクスポートする場合は特に、同時に 5 つを超えるノードから techsupport ファイルの回収をトリガーしないでください。 APIC の過剰なストレージの使用を避けるには、ローカルに保存された techsupport ファイルをすぐに削除してください。 |
techsupport ファイルをエクスポートするリモート パスを設定します。
次に、apic1 コントローラのローカルに保存されるようにスイッチ 101 の techsupport ファイルをトリガーする例を示します。
apic1# trigger techsupport switch 101 Triggering techsupport for Switch 101 using policy supNode101, setting filters to default value Triggered on demand tech support successfully for Switch 101, will be available at: /data/techsupport on the controller. Use 'show techsupport' with your options to check techsupport status.
ACI ファブリックでは、techsupport またはコンフィギュレーション ファイルをエクスポートする 1 つ以上のリモート宛先を設定できます。
次に、ファイルをエクスポートするためにリモート パスを設定する例を示します。
apic1# configure apic1(config)# remote path myFiles apic1(config-remote)# user admin5 You must reset the password when modifying the path: Password: Retype password: apic1(config-remote)# path sftp filehost.example.com:21 remote-directory /reports/apic You must reset the password when modifying the path: Password: Retype password:
障害、イベント、ヘルス、統計情報、および監査ログの show コマンドは、特定のタイプの情報または、コントローラ、リーフ スイッチ、スパイン スイッチ、またはテナントなどの特定のエンティティからの情報を表示するためにフィルタリングできます。
広範なクエリはシステム リソースおよびストレージの面で費用がかかります。たとえば、エンティティのフィルタを使用せずに障害、イベント、監査の show コマンドを使用して、システム全体からすべてのログまたはレコードを検索します。シスコは、可能な限りクエリを絞り込むために、利用可能なデータおよびエンティティのフィルタを使用することを推奨します。たとえば、次のコマンドでは、直近の 45 分間にクエリを制限することで、迅速かつ多くのフィルタリングされた応答が得られます。
show audits last-minutes 45
![]() ヒント |
コマンドの各ポイントで、「?」を入力すると、それぞれの簡単な説明とその時点で使用可能なすべてのキーワードおよびオプションが表示されます。 |
show faults コマンドは、障害の指定のセットを提供するために複数のデータ フィルタとエンティティのフィルタを組み合わせることができます。コマンド構文は次のとおりです。
show faults [filter1 [filter2...]] [entity-filter]
エンティティのフィルタは、出力をコントローラ、リーフ、スパイン、またはテナントの障害に限定します。使用できるエンティティ フィルタを show コマンドのエンティティ フィルタに示します。
データ フィルタは、障害のクエリのタスクを簡単にするためにユーザに提供されます。使用可能なデータ フィルタは次のとおりです。
| フィルタ |
説明 |
|---|---|
| ack {yes | no} |
確認応答の状態 |
| causename |
原因 |
| codefault-code |
障害コード |
| controller |
コントローラ情報 |
| detail |
詳細な障害情報 |
| end-timeYYYY-MM-DDTHR-MM:SS |
この時間までの障害アクティビティ |
| history |
履歴情報 |
| idfault-id |
障害 ID |
| l4l7-cluster[clustername | tenantname] |
L4 L7 デバイス情報 |
| l4l7-graph[clustername | tenantname] |
L4 L7 グラフ情報 |
| last-daysdays |
最後の N 日間の障害アクティビティ |
| last-hourshours |
最後の N 時間の障害アクティビティ |
| last-minutesminutes |
最後の N 分間の障害アクティビティ |
| lclc-state |
ライフサイクルの状態 |
| leaf [leaf-id] |
リーフ スイッチ情報 |
| microsoft domainname |
マイクロソフトのドメイン情報 |
| min-severityseverity-value |
重大度の最小値 |
| severityseverity-value |
重大度 |
| spine [spine-id] |
スパイン スイッチ情報 |
| start-timeYYYY-MM-DDTHR-MM:SS |
この時間以降の障害アクティビティ |
| tenant [name] |
テナント情報 |
| typefault-type |
障害の種類 |
| vmware domainname |
VMware のドメイン情報 |
この例では、コード「F110473」、重要度「warning」、ライフサイクル「raised」およびテナント TSW_Tenant0 の確認応答の状態「no」の過去 5 日間に発生したすべての障害を示します。
apic1# show faults code F110473 last-days 5 severity warning lc raised ack no tenant TSW_Tenant0
Code : F110473
Severity : warning
Last Transition : 2015-11-03T01:19:04.913+00:00
Lifecycle : raised
DN : uni/tn-TSW_Tenant0/BD-tsw0ctx0BD1/fault-F110473
Description : TCA: ingress drop bytes rate(l2IngrBytesAg15min:dropRate)
value 160462 raised above threshold 100000
show events コマンドは、イベントの指定のセットを提供するために複数のデータ フィルタとエンティティのフィルタを組み合わせることができます。コマンド構文は次のとおりです。
show events [filter1 [filter2...]] [entity-filter]
エンティティのフィルタは、出力をコントローラ、リーフ、スパイン、またはテナントのイベントに限定します。使用できるエンティティ フィルタを show コマンドのエンティティ フィルタに示します。
データ フィルタは、イベントのクエリのタスクを簡単にするためにユーザに提供されます。使用可能なデータ フィルタは次のとおりです。
| フィルタ |
説明 |
|---|---|
| causefault-value |
原因 |
| codeevent-code |
イベント コード |
| controller |
コントローラ情報 |
| detail |
詳細なイベント情報 |
| end-timeYYYY-MM-DDTHR-MM:SS |
この時間までのイベント アクティビティ |
| idevent-id |
イベント ID |
| last-daysdays |
最後の N 日間のイベント アクティビティ |
| last-hourshours |
最後の N 時間のイベント アクティビティ |
| last-minutesminutes |
最後の N 分間のイベント アクティビティ |
| leaf [leaf-id] |
リーフ スイッチ情報 |
| spine [spine-id] |
スパイン スイッチ情報 |
| start-timeYYYY-MM-DDTHR-MM:SS |
この時間以降のイベント アクティビティ |
| tenant [name] |
テナント情報 |
この例では、leaf 101 上のすべてのイベントを示します。
apic1# show events leaf 101 Severity : info Affected Object : topology/pod-1/node-101/sys/phys-[eth1/28] Code : E4208843 ID : 8589934758 Cause : transition Description : PhysIf eth1/28 modified Creation Time : 2015-11-03T01:11:16.763+00:00
show health コマンドは、指定のヘルス レポートを提供するために複数のデータ フィルタとエンティティのフィルタを組み合わせることができます。コマンド構文は次のとおりです。
show health [filter1 [filter2...]] [entity-filter]
エンティティのフィルタは、出力をコントローラ、リーフ、スパイン、またはテナントのヘルス スコアに限定します。使用できるエンティティ フィルタを show コマンドのエンティティ フィルタに示します。
データ フィルタは、ヘルスのクエリのタスクを簡単にするためにユーザに提供されます。使用可能なデータ フィルタは次のとおりです。
| フィルタ |
説明 |
|---|---|
| end-timeYYYY-MM-DDTHR-MM:SS |
この時間までのヘルス アクティビティ |
| history |
履歴情報 |
| max-changepercentage |
ヘルス スコア率の最小変化 |
| min-hsscore |
最大ヘルス スコア |
| start-timeYYYY-MM-DDTHR-MM:SS |
この時間以降のヘルス アクティビティ |
この例では、すべてのテナントの簡単なヘルス レポートを示します。
apic1# show health tenant Tenant Score Change(%) Created ------------------------------------------------------------------------ infra 100 0 2015-05-12 18:45:47PDT common 100 0 2015-05-12 18:45:47PDT TSW_Tenant0 98 0 2015-05-12 18:20:58PDT mgmt 100 0 2015-05-12 18:45:47PDT
この例では、テナント TSW_Tenant0 の最小変化 10% で、最大 75 のヘルス スコアのすべての履歴ヘルスレコードを 11 月 4 日から示します。
apic1# show health max-hs 75 min-change 10 start-time 2015-11-04T01:55:48 history tenant TSW_Tenant0
show audits コマンドは、監査ログおよびエンティティのセッション ログを表示するために使用することができます。コマンドは、監査ログの指定のセットを提供するために複数のデータ フィルタとエンティティのフィルタを組み合わせることができます。コマンド構文は次のとおりです。
show audits [filter1 [filter2...]] [entity-filter]
エンティティのフィルタは、出力をコントローラ、リーフ、スパイン、またはテナントのログに限定します。使用できるエンティティ フィルタを show コマンドのエンティティ フィルタに示します。
データ フィルタは、監査ログのクエリのタスクを簡単にするためにユーザに提供されます。使用可能なデータ フィルタは次のとおりです。
| フィルタ |
説明 |
|---|---|
| action {creation | deletion | failure | modification | special | state-transition} |
オブジェクトのアクション インジケータ |
| controller |
コントローラ情報 |
| detail |
詳細なログ情報 |
| end-timeYYYY-MM-DDTHR-MM:SS |
この時間までのログ アクティビティ |
| idlog-id |
ログ ID |
| last-daysdays |
最後の N 日間のログ アクティビティ |
| last-hourshours |
最後の N 時間のログ アクティビティ |
| last-minutesminutes |
最後の N 分間のログ アクティビティ |
| leaf [leaf-id] |
リーフ スイッチ情報 |
| spine [spine-id] |
スパイン スイッチ情報 |
| start-timeYYYY-MM-DDTHR-MM:SS |
この時間以降のログ アクティビティ |
| tenant [name] |
テナント情報 |
| useruser-name |
ユーザの名前 |
この例では、テナント TSW_Tenant0 の最後の 45 分間のすべての監査ログに示します。
apic1# show audits last-minutes 45 tenant TSW_Tenant0
Creation Time : 2015-11-03T01:11:05.708+00:00
ID : 12884902085
User : admin
Action : creation
Affected Object : uni/tn-TSW_Tenant0/out-T0-sub-L3OUT-1/instP-
l3extInstP-1/extsubnet-[192.5.1.0/24]
Description : Subnet 192.5.1.0/24 created
show stats コマンドは、統計情報の指定のセットを提供するためにデータ フィルタとエンティティのフィルタを組み合わせることができます。コマンド構文は次のとおりです。
showstatsgranularitygranularity[cumulative][history] [entity-filter]
エンティティのフィルタは、出力をリーフ、スパイン、またはテナントの統計情報に限定します。使用できるエンティティ フィルタを show コマンドのエンティティ フィルタに示します。
データ フィルタは、統計情報のクエリのタスクを簡単にするためにユーザに提供されます。使用可能なデータ フィルタは次のとおりです。
| フィルタ |
説明 |
|---|---|
| cumulative |
累積統計情報 |
| granularity {5min | 15min | 1h | 1d | 1w | 1mo | 1qtr | 1year} |
5 分、15 分、1 時間、1 日、1 週間、1 ヵ月、1 四半期、または 1 年のサンプリング間隔サイズ |
| history |
履歴統計情報 |
この例では、テナント TSW_Tenant0 の 15 分単位の粒状統計を示します。
apic1# show stats granularity 15min tenant TSW_Tenant0
この例では、特定のポートの 15 分単位の粒状統計を示します。
apic1# show stats granularity 15min leaf 101 interface ethernet 1/1
エンティティ フィルタは、コントローラ、リーフ、スパイン、またはテナントの障害に出力を制限する多くの show コマンドを拡張できます。使用可能なエンティティ フィルタは次のとおりです。
| フィルタ |
|---|
| controller |
| leafnode-id[fex] |
| leafnode-idinterface [ethernetslot/port | l3instanceinstance-name | mgmt[mgmt0] | portchannel | tunneltunnel-name] |
| leafnode-idinventory {chassisnumber | fansnumber | modulenumber | powersupplynumber | supervisornumber} |
| leafnode-idprotocol {arp | bgp | coop | ipv4 | ipv6 | isis | lldp | ospf | ospfv3} |
| leafnode-idvpc { |
| leafnode-idvrfvrf-name |
| spinenode-id |
| spinenode-idinterface [ethernetslot/port | l3instanceinstance-name | mgmt[mgmt0] | tunneltunnel-name] |
| spinenode-idinventory {chassisnumber | fabricnumber | fansnumber | modulenumber | powersupplynumber | supervisornumber | systemnumber} |
| spinenode-idprotocol {arp | bgp | coop | ipv4 | ipv6 | isis | lldp | ospf | ospfv3} |
| spinenode-idvrfvrf-name |
| tenanttenant-name |
| tenanttenant-nameapplicationapp-name[epg] |
| tenanttenant-namebridge-domainbd-name |
| tenanttenant-nameinterfacebridge-domainbd-name |
SNMP 通信を可能にするには、SNMP トラフィック(通常、UDP 161 上)を許可するアウトオブバンド コントラクトを設定する必要があります。