分散トレース

• サービス全体のパフォーマンスを分析します。
• 選択したサービスとその相互依存サービス間の通信フローを視覚化します。
• どのサービスがエラーを示しているかを特定し、エラーのあるサービスをトラブルシューティングします。
• 選択したサービスとその各相互依存サービス間のトランザクションの詳細を表示します。

前提条件

• アプリケーションが東西トラフィックを送信する際に、次のトレースヘッダーを維持していることを確認します。
  
• CICビルド1.7.23以前の場合、CPX YAMLファイルをNS_DISTRIBUTED_TRACINGと値yesで更新します。
  
• CICビルド1.7.23以降の場合、ConfigMapを使用する必要があります。
  ConfigMapを使用すると、構成をポッドから分離し、ワークロードをポータブルにすることができます。ConfigMapを使用すると、ワークロードの構成を簡単に変更および管理でき、構成データをポッド仕様にハードコードする必要がなくなります。
  ConfigMapのサポートにより、NetScaler Ingress Controllerポッドを実行したまま、構成を自動的に更新できます。更新後にポッドを再起動する必要はありません。詳細については、イングレスコントローラーのConfigMapサポートを参照してください。
  ConfigMapを使用して、分散トレース、イベント、監査ログなどを有効または無効にできます。ConfigMapを使用するには：
  1. 必要なパラメータを使用してYAMLファイルを作成します。
     次のYAMLファイルの例では、分散トレースが有効になっており、監査ログ、イベント、トランザクションなどの他の変数は無効になっています。
     apiVersion: v1
kind: ConfigMap
metadata:
  name: cic-configmap
  namespace: default
data:
  LOGLEVEL: 'debug'
  NS_PROTOCOL: 'http'
  NS_PORT: '80'
  NS_HTTP2_SERVER_SIDE: 'ON'
  NS_ANALYTICS_CONFIG:
    distributed_tracing:
      enable: 'true'
      samplingrate: 100
    endpoint:
      server: <Console-AgentIP> / <Console-AppserverIP>
    timeseries:
      port: 5563
      metrics:
        enable: 'true'
        mode: 'avro'
      auditlogs:
        enable: 'false'
      events:
        enable: 'false'
    transactions:
      enable: 'false'
      port: 5557
     注
     Samplingrate の値は0から100の間で指定できます。NetScaler Consoleは、指定された数のトレーストランザクションを表示します。

  2. ConfigMapをデプロイするには、以下を使用します。
     kubectl create -f <configmap-yaml>.yaml
  3. CPX YAMLファイルを編集し、envFrom または args のいずれかを使用して次の引数を指定します。
     envFrom:
 - configMapRef:
     name: cic-configmap
     または
     
  4. いずれかの変数の値を変更したい場合は、ConfigMapの値を編集します。この例では、他のすべての変数が false から true に変更されています。
     apiVersion: v1
kind: ConfigMap
metadata:
  name: cic-configmap
  namespace: default
data:
  LOGLEVEL: 'debug'
  NS_PROTOCOL: 'http'
  NS_PORT: '80'
  NS_HTTP2_SERVER_SIDE: 'ON'
  NS_ANALYTICS_CONFIG:
    distributed_tracing:
      enable: 'true'
      samplingrate: 100
    endpoint:
      server: <Console-AgentIP> / <Console-AppserverIP>
    timeseries:
      port: 5563
      metrics:
        enable: 'true'
        mode: 'avro'
      auditlogs:
        enable: 'true'
      events:
        enable: 'true'
    transactions:
      enable: 'true'
      port: 5557
  5. 次のコマンドを使用してConfigMapを再適用します。
     kubectl apply -f <yaml-file>.yaml

サービス追跡の詳細を表示

• 提案と演算子を使用してトランザクションを検索できる高度な検索 (1)。詳細については、高度な検索を参照してください。
• 1時間、12時間、1日、1週間、1か月、カスタム時間などの時間期間を選択できる時間期間リスト (2)。
• 特定の時間期間の結果を表示するためにドラッグして選択できるタイムライン詳細グラフ (3)。
• 各メトリックからオプションを選択できるフィルターパネル (4)。
• 選択したサービスに関するトランザクションの詳細 (5)。

トランザクションの詳細を表示する

• 開始時刻
• 終了時刻
• SSLメトリック
• 相互依存サービスとの通信 (各サービスのエラーと応答時間を含む)。

• クライアントRTT: パケットがクライアントから移動する時間。
• サーバーRTT: パケットがサーバーから移動する時間。
• アプリ応答時間: アプリケーションの平均応答時間
• データ転送時間: サービスとの間で転送が発生する可能性のあるデータ転送サイズと転送速度。
• ロケーション: クライアントのロケーション
• ブラウザ: クライアントが使用するブラウザの種類。例: Chrome、Firefox。
• クライアントOS: ブラウザのユーザーエージェントの詳細に基づくクライアントOS。
• デバイス: ブラウザのユーザーエージェントの詳細に基づくデバイス。例: タブレット、モバイル。
• リクエストタイプ: トランザクションのリクエストタイプ。例: GET。
• レスポンスコード: サーバーから受信したレスポンスコード。例: 501、404、200。
• レスポンスコンテンツタイプ: トランザクションのコンテンツタイプ。クライアントのリクエストがtext/htmlの場合、サーバーからのレスポンスもtext/htmlである必要があります。
• SSLプロトコル: クライアントが使用するSSLプロトコルバージョン。例: SSLv3。
• SSL暗号強度: 高、中、低などのSSL証明書キーサイズに基づく暗号強度。
• SSLキー強度: SSL暗号強度はSSL証明書キーサイズから計算されます。キー長はSSLアルゴリズムのセキュリティを定義します。例: 2048
• SSLフロントエンド障害理由: フロントエンドのSSLハンドシェイクエラーメッセージ。例: SSL CLIENTAUTH FAILURE