ユーザーインターフェースを介したテレメトリ診断ツールの追加

このトピックでは、のユーザーインターフェースを通じて IBM® watsonx.data、( Java ) Presto エンジンにテレメトリ診断ツールを追加する手順を説明します。

開始前に

テレメトリツール（Instana または Prometheus ）の watsonx.data コンソールと認証情報へのアクセス権を確保してください。

Instana または ツール Prometheus は、要件に基づいて以下の手順に従ってインストールする必要があります：

手順

  1. watsonx.data コンソールにログインします。

  2. ナビゲーションメニューから「 設定 」を選択し、をクリックします OpenTelemetry。

  3. ページ OpenTelemetry で、 [診断] をクリックします。

  4. テレメトリ診断の追加ウィンドウで、以下の詳細を入力してください：

    テレメトリ診断の詳細を追加する
    フィールド 説明
    利用可能なテレメトリツール リストからテレメトリ診断ツール（Instana）を選択してください Prometheus。
    テレメトリー・エンドポイント 選択した URL ツールの終点を入力してください。 フォーマット: http://<host>:<port>/<path> または https://<host>:<port>/<path>. GRPC経由のOTLPには 4317 ポートを使用し、経由の 4318 OTLPには HTTP ポートを使用してください。
    ホスト名 選択したテレメトリツールがInstanaの場合、ツールのホストIDを入力してください。 リソース属性の設定を参照してください。
    パスワード Instana エージェントキーまたは Prometheus パスワードを入力してください。
    接続状況 「接続テスト」 をクリックして、エンドポイントと認証情報を検証します。
    関連診断 チェックボックスを選択して、テレメトリツールに診断タイプ（ログ、メトリクス、トレース）を関連付けます。

    現在、Instanaはメトリクスとトレースの診断データのみを提供しています。 Prometheus 診断データのみを提供する。

  5. [追加] をクリックしてテレメトリツールの統合を適用します。

    ユーザーはポッドが再起動するまで、短時間待つ必要がある場合があります。

  6. インスタンスでサポートされているエンジンの診断メトリクス一覧にアクセスして確認するには、ドロップダウンメニューを使用して次の操作を行います：

    • 有効化: 診断を有効にします。
    • 無効化: データ収集を一時停止します。
    • 編集 ：設定の詳細を更新する。
    • 詳細を表示 ：現在の設定を確認する。
    • 診断を解除する ：エンジンから診断装置を取り外す。

    サポートされているすべての診断タイプが、いずれか一方または両方のテレメトリツールに正常に関連付けられると、「 診断を追加」 ボタンは無効になります。

    新しい診断ツールを設定するか、別のツールに切り替えるには、次のいずれかを実行する必要があります：

    • 既存の設定を編集する。
    • 現在の診断を無効にします。
    • それを切り離す。

診断テレメトリデータに移動する

診断テレメトリ（内部および合成コールを含む）を確認するには：

  1. Instana UI にログインしてください。
  2. アナリティクス → アプリケーション → コールに移動します。
  3. 左側のパネルで、 [非表示の通話] セクションを探してください。
  4. 以下のオプションを使用可能に設定します。
    • 合成呼び出しの表示
    • 内部呼び出しの表示

これにより、診断に関連するすべての内部データ、システム生成データ、および合成コールデータがUI上で可視化されます。

特定のクエリのトレースをCRNを使用して表示する

  1. アナリティクス → アプリケーション → コールに移動します。
  2. フィルターを追加を選択してください。
  3. フィルター検索バーで入力 OpenTelemetry → カスタム → crn.
  4. crn 属性を選択し、希望の値に設定してください <crn_value>。
  5. 保持期間を調整して、最近のトレース活動に焦点を当てる:
    • 過去 5 分
    • 直近 10 分
    • 直近 30 分間

これらの保持期間は、古い呼び出しのノイズなしに、最近のクエリ実行トレースを可視化することを保証します。

Instanaでのメトリクスの OpenTelemetry 表示

  1. Instana UIにログインし、 「インフラストラクチャの分析」 に移動します。
  2. データソースセレクターで、すべての OpenTelemetry リソースを表示するには OpenTelemetry を選択してください。
  3. 「フィルタを追加」 をクリックし、 リソース → otel.attributeOpenTelemetry → k8s.namespace.name を選択します。 ビューをフィルタリングするために必要な watsonx.data インスタンス名前空間を入力してください。
  4. フィルタリングされた結果から、ご自身のインスタンスに関連付けられたエンドポイント metric-scraper-presto を選択してください。
  5. 「メトリクスを選択」 を使用して、 Presto メトリクススクレイパーによって公開されているすべての利用可能な OpenTelemetry メトリクスを参照してください。
  6. 任意の指標を選択すると、その指標のリアルタイム時系列可視化が開きます。ここでは現在の値、傾向、および属性を分析できます。

UI Prometheus でのメトリクスの表示

  1. 環境の Prometheus UIにアクセスしてください。
  2. 式フィールドで、メトリック名（例： presto_）の入力を開始します。
  3. Prometheus 自動的に metric-scraper-presto から収集されたすべてのメトリクスを表示します。
  4. 必要なメトリックを選択し、 [実行 ]をクリックして結果を表示します。