IBM サポートが私の CLI API リクエストを追跡するにはどうすればよいですか？

CLI関連の問題を調査する場合、効果的なトレーサビリティは、完全で適切にフォーマットされたリクエストデータを受け取ることに依存する。 CIS CLIの新しい X-Request-ID ヘッダーは、システム全体の透明性と追跡可能性を向上させ、 IBM サポートが問題を効率的に特定・解決することを容易にします。

IBM 共有いただくログに必要なリクエスト識別子が欠落している場合、サポートチームは特定のCLI経由のAPI呼び出しを追跡する際に困難に直面する可能性があります。

CLIはすべてのAPIリクエストに X-Request-ID ヘッダーを自動的に含めますが、トレースログを収集して共有するときに、この情報が不注意に除外されることがあります。 これがないと、サポートチームはバックエンドシステム全体でリクエストを追跡できない可能性がある。

IBM サポートがリクエストを適切に追跡および分析できるように、CLIログの取得と共有時には以下の手順に従ってください：

1. 問題を再現する前に、CLIからトレースログ記録を有効にしてください。

2. API リクエストとレスポンスの完全なログを取得し、共有する。これには X-Request-ID と、もしあればレスポンスの X-Correlation-Id も含まれる。

3. 以下のような詳細を探す：

   REQUEST: [2025-07-17T19:47:24+05:30]
   POST /v1/crn:v1:staging:public:internet-svcs-ci:global:a/01652b251c3ae2787110a995d8db0135:1a9174b6-0106-417a-844b-c8eb43a72f63::/rules/lists HTTP/1.1
   Host: api-int.cis.dev.cloud.ibm.com
   Accept: application/json
   Authorization: [PRIVATE DATA HIDDEN]
   Content-Type: application/json
   X-Auth-User-Token: [PRIVATE DATA HIDDEN]
   
   {"name":"ac","kind":"asn"}
   
   RESPONSE: [2025-07-17T19:47:25+05:30] Elapsed: 1189ms
   HTTP/2.0 200 OK
   Cache-Control: no-cache, no-store, must-revalidate
   Cf-Cache-Status: DYNAMIC
   Cf-Ray: 960a5cd87e565520-DEL
   Content-Security-Policy: frame-ancestors 'none'; default-src 'self'; form-action 'self'
   Content-Type: application/json
   Date: Thu, 17 Jul 2025 14:17:25 GMT
   Server: cloudflare
   Strict-Transport-Security: max-age=31536000; includeSubdomains
   X-Content-Type-Options: nosniff
   X-Correlation-Id: f9e06c3c-8276-4436-9ad3-0bf63c27291c
   X-Envoy-Upstream-Service-Time: 842
   

4. IBM サポートが問題の切り分けとデバッグを迅速に行えるよう、この情報をサポートケースに添付してください。

   ログを外部と共有する前に、認証トークンなどの機密データを必ず再編集してください。