サードパーティ監視システムへのテレメトリーデータのエクスポート

高度な用途および Titanium サブスクリプションランク​で利用できる機能

Telemetry Exporter を使用すると、​監査ログ​やトレースデータをアプリケーションからサードパーティオブザーバビリティおよび分析アプリケーション (Azure Monitor、Splunk HEC、OpenTelemetry 準拠ツールなど) にエクスポートできます。トレースデータのエクスポートは、互換性のあるバージョンの CloudHub 2.0 および Runtime Fabric を使用してデプロイされたアプリケーションでのみサポートされます。

Telemetry Exporter を使用するには、以下を実行する必要があります。

  • Anypoint Platform でデータを共有できるようにサードパーティアプリケーションとの接続を作成する。

  • Anypoint Platform でエクスポートするデータの種別と、コンテンツを接続にエクスポートできるビジネスグループおよび環境設定を指定する設定を作成する。

接続や設定を編集および削除することもできます。 Unresolved include directive in modules/ROOT/pages/telemetry-exporter.adoc - include::partial$telemetry-exporter-notes.adoc[]

Unresolved include directive in modules/ROOT/pages/telemetry-exporter.adoc - include::partial$telemetry-exporter-notes.adoc[]

サポートされているサードパーティ監視製品

Telemetry Exporter を使用すると、大部分のサードパーティオブザーバビリティおよび分析アプリケーションとの接続を作成できます。この接続により、以下のことが可能になります。

  • OpenTelemetry でサポートされるエンドポイントを設定する。たとえば、New Relic のエンドポイント URL は ​https://otlp.nr-data.net:4318​ になります。

  • インストルメンテーションキーまたはアクセストークンを作成できるようにする。

Azure Monitor と Splunk HEC も互換性があります。

始める前に

Telemetry Exporter を設定する前に、以下があることを確認します。

  • Anypoint Integration Advanced パッケージまたは Anypoint Platform の Titanium サブスクリプション。

  • 「Telemetry Exporter Administrator (Telemetry Exporter 管理者)」権限。この権限により、接続を作成または変更できます。

  • 「Telemetry Exporter Configurations Manager (Telemetry Exporter 設定マネージャー)」権限。この権限により、設定を作成または変更できます。

  • サードパーティアプリケーションのアクセス情報 (エンドポイントなど)。

  • サードパーティアプリケーションのインストルメンテーションキーまたはアクセストークンを作成する機能。

  • 共有​または​非公開スペース​にデプロイされた CloudHub 2.0 アプリケーションで有効化されたトレースデータ収集。この要件は、CloudHub 2.0 のトレースデータをエクスポートする場合にのみ適用されます。

  • Runtime Fabric​ で有効化されたトレースデータ収集。この要件は、Runtime Fabric のトレースデータをエクスポートする場合にのみ適用されます。

Telemetry Exporter にアクセスする

Unresolved include directive in modules/ROOT/pages/telemetry-exporter.adoc - include::partial$include-nav-steps-telemetry-permissions.adoc[]

[Configurations (設定)]​ タブと ​[Connections (接続)]​ タブを切り替えて、データ設定やサードパーティアプリケーションとの接続を作成、編集、または表示できます。

接続の管理

Anypoint Platform には、データをサードパーティアプリケーションに送信する権限が必要です。データを転送できるように New Relic や Splunk などのサードパーティアプリケーションとの接続を作成します。最大 10 個の接続を設定できます。

Unresolved include directive in modules/ROOT/pages/telemetry-exporter.adoc - include::partial$telemetry-exporter-notes.adoc[]

接続を作成する

Unresolved include directive in modules/ROOT/pages/telemetry-exporter.adoc - include::partial$include-nav-steps-telemetry-permissions.adoc[]

  1. [Connections (接続)]​ タブをクリックします。

  2. [New Connection (新規接続)]​ をクリックします。

  3. [Connection Details (接続の詳細)]​ ページで、次の情報を入力します。

    • Connection Name (接続名)​: 接続の名前 (英数字とハイフンのみを使用)。

    • [Destination Type (宛先種別)]​: データを転送するサードパーティアプリケーション。

    • [Endpoint URL (エンドポイント URL)]​: サードパーティアプリケーションへの外部接続を有効にするエンドポイント。このエンドポイントの場所は、アプリケーションによって異なります。

  4. [Next (次へ)]​ をクリックします。

  5. [Authentication (認証)]​ ページで、アプリケーションの認証に必要な情報を入力します。アクセストークンのみが必要なアプリケーションと、ヘッダーキーも必要なアプリケーションがあります。

  6. [Test Connection (接続をテスト)]​ をクリックして、Anypoint Platform がサードパーティアプリケーションに接続できることを確認します。

  7. [Save Connection (接続を保存)]​ をクリックします。

    [Telemetry Exporter]​ ページの ​[Connections (接続)]​ タブに新しい接続が表示されます。

接続を編集する

Unresolved include directive in modules/ROOT/pages/telemetry-exporter.adoc - include::partial$include-nav-steps-telemetry-permissions.adoc[]

  1. [Connections (接続)]​ タブをクリックします。

  2. 編集する接続の横で、​[…​]​ をクリックし、​[Edit Connection (接続を編集)]​ を選択します。

  3. [Connection Details (接続の詳細)]​ ページで、変更する各項目を編集し、​[Next (次へ)]​ をクリックします。

  4. [Authentication (認証)]​ ページで、変更する各項目を編集し、​[Test Connection (接続をテスト)]​ をクリックします。

  5. 正常に接続できた場合は、​[Save Connection (接続を保存)]​ をクリックします。

接続を削除する

Unresolved include directive in modules/ROOT/pages/telemetry-exporter.adoc - include::partial$include-nav-steps-telemetry-permissions.adoc[]

  1. 削除する接続の横で、​[…​]​ をクリックし、​[Delete Connection (接続を削除)]​ を選択します。

  2. 次の場合、警告が表示されます。

    • 接続が使用中でない場合、接続を削除するかどうかが警告で尋ねられます。​[Delete Connection (接続を削除)]​ をクリックします。

    • 接続が使用中の場合、設定で使用されている接続を削除またはリダイレクトする必要があることが警告で示されます。​[Dismiss (中止)]​ をクリックし、現在の接続を削除する前に他の既存の接続を使用するように​設定を編集します​。

設定を管理する

サードパーティアプリケーションへの接続を作成したら、サードパーティアプリケーションに送信するデータのスコープを指定する設定を作成する必要があります。新しい設定を作成するときに、データ種別、ビジネスグループ、環境種別 (トレースのみ)、宛先を指定します。すべてのビジネスグループまたは特定のビジネスグループのトレースおよび監査ログをエクスポートできます。

Unresolved include directive in modules/ROOT/pages/telemetry-exporter.adoc - include::partial$telemetry-exporter-notes.adoc[]

設定を作成する

Unresolved include directive in modules/ROOT/pages/telemetry-exporter.adoc - include::partial$include-nav-steps-telemetry-permissions.adoc[]

  1. [New Configuration (新規設定)]​ をクリックします。

  2. [General Information (一般情報)]​ ページで、次の情報を入力します。

    • Configuration Name (設定名)​: 設定の名前 (英数字のみを使用)。

    • Connection (接続)​: 設定した既存の接続。

    • Data Type (データ種別)​: 監査ログまたはトレースデータ

  3. [Next (次へ)]​ をクリックします。

  4. [Select Business Group (ビジネスグループを選択)]​ セクションで、次のいずれかを選択します。

    • All business groups (すべてのビジネスグループ)​: 監査ログは、組織のすべてのビジネスグループから取得されます。

    • Select a business group (ビジネスグループを選択)​: 指定した種別のデータが、選択されたビジネスグループから取得されます。

  5. [Next (次へ)]​ をクリックします。

  6. データ種別としてトレースデータを選択した場合、環境種別を選択します。

    • Production (本番)

    • Sandbox

    • Design (設計)

  7. [Save Configuration (設定を保存)]​ をクリックします。

設定を編集する

設定を編集するときに、設定名と接続を変更できます。データ種別、ビジネスグループ、または環境種別を変更する場合は、新しい設定を作成する必要があります。

Unresolved include directive in modules/ROOT/pages/telemetry-exporter.adoc - include::partial$include-nav-steps-telemetry-permissions.adoc[]

  1. 編集する設定の横で、​[…​]​ をクリックし、​[Edit Configuration (設定を編集)]​ を選択します。

  2. [General Information (一般情報)]​ ページで、変更する各項目を編集し、​[Next (次へ)]​ をクリックします。

  3. [Business Group & Environment Type (ビジネスグループ & 環境種別)]​ ページで、​[Next (次へ)]​ をクリックします。

  4. [Save Configuration (設定を保存)]​ をクリックします。

設定を削除する

Unresolved include directive in modules/ROOT/pages/telemetry-exporter.adoc - include::partial$include-nav-steps-telemetry-permissions.adoc[]

  1. 削除する設定の横で、​[…​]​ をクリックし、​[Delete Connection (接続を削除)]​ を選択します。

    設定を削除するかどうかを確認する警告が表示されます。

  2. [Delete Configuration (設定を削除)]​ をクリックします。

既知の問題

Unresolved include directive in modules/ROOT/pages/telemetry-exporter.adoc - include::partial$telemetry-exporter-notes.adoc[]

Unresolved include directive in modules/ROOT/pages/telemetry-exporter.adoc - include::partial$telemetry-exporter-notes.adoc[]