NSX-T Data Center のコンポーネントは、/var/log ディレクトリのログファイルに書き込みます。NSX-T アプライアンスと KVM ホストの NSX Syslog メッセージは RFC 5424 に準拠しています。ESXi ホストの Syslog メッセージは RFC 3164 に準拠しています。

ログの表示

NSX-T アプライアンスの Syslog メッセージは /var/log/syslog にあります。KVM ホストの Syslog メッセージは /var/log/vmware/nsx-syslog に含まれています。

NSX-T アプライアンスでは、次の NSX-T CLI コマンドを実行してログを表示できます。
get log-file <auth.log | controller | controller-error | http.log | kern.log | manager.log | node-mgmt.log | policy.log | syslog> [follow]
ログ ファイルは次のとおりです。
名前 説明
auth.log 認証ログ
controller コントローラ ログ
controller-error コントローラ エラー ログ
http.log HTTP サービス ログ
kern.log カーネル ログ
manager.log マネージャ サービス ログ
node-mgmt.log ノード管理ログ
nsx-audit-write.log NSX 監査の書き込みログ
nsx-audit.log NSX 監査ログ
policy.log ポリシー サービス ログ
Syslog システム ログ

ハイパーバイザーでは、tactailgrepmore などの Linux コマンドを使用してログを表示できます。

各 Syslog メッセージには、メッセージの送信元を識別するためのコンポーネント (comp) 情報とサブコンポーネント (subcomp) 情報が含まれます。

NSX-T Data Center は、facility local6 のログ(数値 22)を生成します。

監査ログは Syslog の一部です。監査ログ メッセージは、structured-data フィールドの文字列 audit="true" で識別できます。ログ メッセージを受信するように外部のログ サーバを構成することができます。API /api/v1/administration/audit-logs を使用して監査ログにアクセスすることもできます。nsx-audit ファイルの Syslog メッセージでは、structured-data フィールドが audit="true" に設定されています。nsx-audit-write ファイルの Syslog メッセージでは、structured-data フィールドに audit="true"update="true" の両方が設定されています。

各 Syslog および監査ログ メッセージには、NTP サーバ(構成されている場合)またはシステム クロックによって生成されたタイムスタンプが含まれます。監査ログ メッセージの例:
<182>1 2020-05-05T00:29:02.900Z nsx-manager1 NSX 14389 - [nsx@6876 audit="true" comp="nsx-manager" level="INFO" reqId="fe75651d-c3e7-4680-8753-9ae9d92d7f0c" subcomp="policy" username="admin"] UserName="admin", ModuleName="AAA", Operation="GetCurrentUserInfo", Operation status="success"
API 呼び出しは、NSX Manager、ポリシー API クライアント、または NSX ノードから行われます。すべての API 呼び出しは認証と認可の対象となり、監査ログが生成されます。このログはデフォルトで有効になっており、無効にすることはできません。API 呼び出しに関連付けられた監査ログには、次の情報が含まれます。
  • API のオブジェクトを識別するためのエンティティ ID パラメータ entId
  • 特定の API 呼び出しを識別するためのリクエスト ID パラメータ req-id
  • API 呼び出しにヘッダー X-NSX-EREQID:<string> が含まれている場合は、外部リクエスト ID パラメータ ereqId
  • API 呼び出しにヘッダー X-NSX-EUSER:<string> が含まれている場合は、外部ユーザー パラメータ euser
ポリシーまたはマネージャ API 呼び出しの監査ログ メッセージには、次の追加フィールドがあります。ノード API (NAPI) と CLI の監査ログには、これらのフィールドはありません。
  • API 操作が読み取り (GET) か書き込み (PUT/POST/DELETE/...) かを示す update フラグ。
  • API 操作の名前を示す operation name フィールド。
  • API 操作の成功または失敗を示す operation status フィールド。
  • API 要求のすべてのパラメータ値を示す new value フィールド。

NSX-T には特権モードの概念がありません。すべての送信元とユーザーからの API 呼び出しが監査対象になります。

ログインの成功、ログインの失敗、2 つの異なるデバイスからのログイン(IP アドレスが異なります)を示すログイン/ログアウトの Syslog メッセージの例:
2020-07-07T16:33:20.339Z svc.nsxmanager NSX 1513 SYSTEM [nsx@6876 audit="true" comp="nsx-manager" level="INFO" subcomp="http"] UserName="[email protected]", ModuleName="ACCESS_CONTROL", Operation="LOGIN", Operation status="success"

2020-07-07T16:33:58.779Z svc.nsxmanager NSX 1513 SYSTEM [nsx@6876 audit="true" comp="nsx-manager" level="INFO" subcomp="http"] UserName="admin", ModuleName="ACCESS_CONTROL", Operation="LOGOUT", Operation status="success"

2020-07-07T16:50:21.301Z svc.nsxmanager NSX 1513 SYSTEM [nsx@6876 audit="true" comp="nsx-manager" level="INFO" subcomp="http"] UserName="[email protected]", ModuleName="ACCESS_CONTROL", Operation="LOGIN", Operation status="success"

2020-07-07T16:43:20.339Z svc.nsxmanager NSX 1513 SYSTEM [nsx@6876 audit="true" comp="nsx-manager" level="INFO" subcomp="http"] UserName="[email protected]", ModuleName="ACCESS_CONTROL", Operation="LOGIN", Operation status="failure"
ポリシー API 呼び出しの Syslog メッセージの例:
<182>1 2020-07-06T18:09:14.210Z svc.nsxmanager NSX 2326 FABRIC [nsx@6876 audit="true" comp="nsx-manager" entId="68d5a9d0-4691-4c9c-94ed-64fd1c96150f" level="INFO" reqId="4c2335aa-c973-4f74-983f-331a4f7041ca" subcomp="manager" update="true" username="admin"] UserName="admin", ModuleName="TransportZone", Operation="CreateTransportZone", Operation status="success", New value=[{"transport_type":"OVERLAY","host_switch_name":"nsxvswitch","host_switch_mode":"STANDARD","nested_nsx":false,"is_default":false,"display_name":"1-transportzone-1307","_protection":"UNKNOWN"}]
CLI アクセスの Syslog メッセージの例:
2020-07-07T16:36:41.783Z svc.nsxmanager NSX 21018 - [nsx@6876 comp="nsx-manager" subcomp="cli" username="admin" level="INFO"] NSX CLI started (Manager, Policy, Controller) for user: admin
2020-07-07T16:36:53.469Z svc.nsxmanager NSX 21018 - [nsx@6876 comp="nsx-manager" subcomp="cli" username="admin" level="INFO"] NSX CLI stopped for user: admin
ユーザーが CLI コマンド(ここでは set user admin password-expiration 100)を実行するときの Syslog メッセージの例:
<182>1 2020-07-22T20:51:49.017Z manager2 NSX 1864 - [nsx@6876 comp="nsx-manager" subcomp="cli" username="admin" level="INFO" audit="true"] CMD: set user admin password-expiration 100 (duration: 2.185s), Operation status: CMD_EXECUTED
NAPI 呼び出しの Syslog メッセージの例:
<182>1 2020-07-21T21:01:38.803Z manager2 NSX 4690 - [nsx@6876 comp="nsx-manager" subcomp="node-mgmt" username="admin" level="INFO" audit="true"] admin 'GET /api/v1/node/services/syslog/exporters' 200 731 "" "PostmanRuntime/7.26.1" 0.004588
CLI コマンドの Syslog メッセージの例:
<182>1 2020-07-21T20:54:40.018Z manager2 NSX 16915 - [nsx@6876 comp="nsx-manager" subcomp="cli" username="admin" level="INFO" audit="true"] CMD: set logging-server 1.1.1.1 proto udp level info (duration: 4.356s), Operation status: CMD_EXECUTED

RFC 5424 および RFC 3164 では、次の重要度が定義されています。

重要度 説明
0 緊急:システムが不安定な状態
1 アラート:迅速な対応が必要な状態
2 重大:重大な問題がある状況
3 エラー:エラーが発生した状態
4 警告:警告が発生した状態
5 通知:正常ではあっても注意を要する状態
6 情報:情報メッセージ
7 デバッグ:デバッグレベルのメッセージ

重要度が緊急、アラート、重大、またはエラーのすべてのログには、ログ メッセージの構造化データに、一意のエラー コードが記載されます。エラー コードは文字列と 10 進数で構成されます。文字列は特定のモジュールを表わします。

ログ ファイルまたはリモート ログ サーバへのアクセス失敗

NSX-T がログ ファイルへのアクセスまたはメッセージの書き込みに失敗した場合、アラームが生成されます。想定されるエラーは次のとおりです。

  • ローカル ログ ファイルがない。
  • ローカル ログ ファイルの権限または所有権の設定により、NSX-T がファイルに書き込むことができない。
  • NSX-T がサードパーティのリモート ログ サーバにログ メッセージを送信できない。NSX-T が Log Insight エージェントにログを送信できない場合、アラームは発生しません。

アラームは、アラーム フレームワークで解決できます。

ログ メッセージの形式

RFC 5424 の詳細については、https://tools.ietf.org/html/rfc5424 を参照してください。RFC 3164 の詳細については、https://tools.ietf.org/html/rfc3164 を参照してください。

RFC 5424 は、ログ メッセージの次の形式を定義します。

<facility * 8 + severity> version UTC-TZ hostname APP-NAME procid MSGID [structured-data] msg
ログ メッセージのサンプル:
<187>1 2016-03-15T22:53:00.114Z nsx-manager NSX - SYSTEM [nsx@6876 comp="nsx-manager" errorCode="MP4039" subcomp="manager"] Connection verification failed for broker '10.160.108.196'. Marking broker unhealthy.

エラー コード

エラー コードの完全なリストについては、ナレッジベースの記事 KB71077NSX-T Data Center 2.x Error Codesを参照してください。