前提条件

グローバル・データリンクを作成するには、管理者である必要があります。

管理者アクセスの付与については、「Splunk Observability Cloud でユーザーを作成および管理する」を参照してください。

グローバル・データリンクの作成

この手順では、グローバル・データリンク・ページを使用して、利用可能なすべてのメタデータのグローバル・データリンクを作成する方法について説明します。

Splunk Observability Cloud API を使用してグローバルデータリンクを作成する方法については、『Splunk Observability Cloud 開発者ガイド』の「メタデータを関連コンテンツにリンクする」のトピックを参照してください。

Splunk APM プロパティのグローバルデータリンクを作成する方法については、「APM のサービス、トレース、スパンを関連リソースにリンクする」を参照してください。

1. Splunk Observability Cloudのメインメニューで、Settings を選択し、次に Global Data Links を選択します。

2. New Link を選択します。

3. Link Labelフィールドに、グローバルデータリンクテキストとして表示したいテキストを入力します。

4. [Link to] フィールドで、リンクターゲットタイプを選択します。グローバルデータリンクのターゲットを次の中から選択します。

   • Custom URL：カスタムURLへのリンク。

   • Splunk：Splunk Cloud PlatformまたはSplunk Enterpriseへのリンク。

   • [Splunk Observability Cloud Navigator]：Splunk Observability Cloud のナビゲータへのリンク。[Choose Navigator] を選択し、リンク先のナビゲータを選択します。

   • [Splunk Observability Cloud Dashboard]：Splunk Observability Cloud のダッシュボードへのリンク。[Choose Dashboard] を選択し、リンクするダッシュボードを選択します。

   • Kibana: Kibanaログへのリンク。

   • AppDynamics tier: Splunk AppDynamicsティアへのリンク。

5. Show Onリストで、グローバルデータリンクを表示する場所を示す値を選択します。

   • [Any Metadata Value]：任意のメタデータ値のリンクを表示します。このオプションは [Link to] フィールドを [Splunk Observability Cloud Dashboard] に設定した場合には使用できません。

   • Any Value of：特定のメタデータの任意の値のリンクを表示します。

     例えば、Any Value ofを選択し、aggregration_typeを入力すると、aggregration_typeの値のリンクが表示されます。

   • Property:Value Pair特定のメタデータの特定の値のリンクを表示します。

     例えば、Property:Value Pairを選択し、aggregration_type:averageを入力すると、averageのaggregation_typeの値のリンクのみが表示されます。

   • [Inferred service]：推定サービスのリンクを表示します。推定サービスの詳細については、「推定サービスのパフォーマンスを推測する」を参照してください。

6. [Show On] 値と 1 つ以上の追加条件に基づいてリンクを表示する場合は、[Add Conditions] を選択します。複数の条件を定義すると、リンクはすべての条件が満たされた場合にのみ表示されます。

   Any Value ofとProperty:Value Pairオプションの使い方については、前のステップを参照してください。

7. [Link to] フィールドを [Custom URL]、[Splunk]、[Kibana]、または [AppDynamics tier] に設定すると、[URL] フィールドが表示されます。グローバルデータリンクの導入先となる URL を入力します。

   Splunk AppDynamics 階層にリンクするための手順と URL 要件の詳細については、「APMプロパティをSplunk AppDynamics階層にリンクする」を参照してください。

   [Custom URL] および [Kibana] リンクターゲットタイプの場合は、オプションとして URL に次のプレースホルダ変数のいずれかを使用できます。グローバルデータリンクを選択すると、変数は実際の値に置き換えられ、宛先 URL が作成されます。

   • {{key}}：この変数を使用して、リンクが表示されるコンテキストからキー名を入力します。たとえば、[Show on] を [aggregation_type] に設定した場合、 URLの aggregation_type は {{key}} に置き換えられます。

   • {{value}}：この変数を使用して、リンクが表示されるコンテキストからキーの値を入力します。たとえば、[Show on] を [aggregation_type] に設定し、コンテキスト内の [aggregation_type] の値が [average] の場合、URL 内の average は {{value}} に置き換えられます。

   • {{start_time}}：この変数を使用して、リンクが表示されるコンテキストから時間枠の開始時刻を入力します。システムは、[Time Format] フィールドで選択したフォーマットを使用してタイムスタンプを挿入します。

   • {{end_time}}：この変数を使用して、リンクが表示されるコンテキストから時間枠の終了時刻を入力します。システムは、[Time Format] フィールドで選択したフォーマットを使用してタイムスタンプを挿入します。

   • {{properties.<property_name>}}：この変数を使用して、リンク表示のコンテキストから他のメタデータを入力します。たとえば、[properties] には、グローバルデータリンク表示のコンテキストで表示されるメタデータキーの名前と値のマップが含まれています。このマップから名前と値を挿入するには、{{properties.<your_property_name>}} を使用します。プロパティ名にピリオドを含める場合は、値を角カッコで囲みます。たとえば、{{properties.[<property.name>]}} のようになります。

8. [Custom URL] または [Kibana] の [Link to] 値を選択すると、[Time Format] フィールドが表示されます。このフィールドを設定して、グローバルデータリンクの開始タイムスタンプと終了タイムスタンプに使用するタイムスタンプ形式を選択します。このフィールドを設定すると、リンク先の外部システムとの互換性を確保することにも役立ちます。次のいずれかの時間形式を選択します。

   • ISO 8601: YYYY-MM-DDThh:mm:ss.SSSZ

   • Unix Time: epoch milliseconds

   • Unix Time: epoch seconds

9. [Custom URL] 、[Splunk]、[Kibana] のいずれかの [Link to] 値を選択すると、[Minimum Time Window] フィールドが表示されます。このフィールドで示す時間ウィンドウとは、システムがチャート、ダッシュボード、サービスマップ、またはトレースデータをキャプチャする間隔です。この間隔がここで選択した最小時間ウィンドウ値より短い場合、グローバルデータリンクは開始時刻を早い時刻に調整し、間隔が最小時間ウィンドウと同じ長さになるようにします。

10. [Link to] の値として [Custom URL]、[Splunk]、[Kibana] のいずれかを選択すると、[Property mapping] オプションが表示されます。[URL] 値に含まれる、リンク先の外部システムで参照される Splunk Observability Cloud のキー名と値が異なる場合は、プロパティマッピングを使用します。

    たとえば、プロパティマッピングを使用して、[host] などの Splunk Observability Cloud キー名を [hostname] などの外部システムキー名にマッピングできます。プロパティマッピングを使用して、[host] などの Observability キー名と [west-internal-123456] などのキー値を、[hostname] などの外部システムキー名と [123456-west-int] などのキー値にマッピングすることもできます。

    プロパティマッピングを使用するには、[Choose a Property] を選択して、Splunk Observability Cloud のキー名またはキー名と値のペアを選択します。次に、マップする外部キー名またはキー名と値のペアを [External Term] フィールドに入力します。

11. Save を選択します。

また、グローバル・データリンクを作成できる Splunk Observability Cloud の他の場所をいくつか紹介します。

• データリンクを含むアラートメッセージを表示する場合、データリンクの横にある [More] メニュー（...）を選択し、[Configure data links] を選択します。

• ダッシュボードで、[Dashboard actions] メニューから [Data Links] を選択します。組織に既存のグローバルデータリンクが定義されている場合は、[Data Links] タブにその旨のメッセージが表示されます。Global Data Links を選択します。

• Splunk Infrastructure Monitoring ナビゲーターでリストを表示する際、任意のプロパティの Actions メニューを選択し、Configure data links を選択します。

• APM [Service Map] で推定サービスを表示する際、推定サービス名の横にある [(⋯)] メニューを選択します。次に、[Configure data links] を選択します。

• ダッシュボードからデータリンクを作成するときにグローバル・データリンクを作成するには、Entire Organization のスコープを選択します。

カスタムURLグローバル・データリンク設定例

[Global Data Links] ページで入力するフィールド値を説明するために、カスタム URL へのグローバルデータリンクの設定例を示します。

このグローバルデータリンクは、aggregation_typeメタデータをダッシュボードに表示します。

グローバルデータリンクを選択すると、[Global Data Links] ページで定義した URL がすぐに表示されます。たとえば、次の例で定義されている URL について考えてみます。

https://www.example.com/search/?field={{key}}&value={{value}}&service={{properties.unit}}&st={{start_time}}&et={{end_time}}

aggregation_typeメタデータ値のtotalのグローバルデータリンクを選択すると、URLは以下の形式で表示されます。

https://www.example.com/search/?field=aggreg-type&value=ttl&service=Bytes&st=2021-09-02T01:13:30.000Z&et=2021-09-02T01:18:30.000Z

その他のグローバルデータリンクの構成例については、次のトピックを参照してください。これらのトピックは Splunk APM プロパティに固有のものですが、ガイダンスはどのプロパティにも適用できます。

• APMのプロパティをSplunkプラットフォームのログにリンクする

• APMのプロパティをKibanaのログにリンクする

グローバル・データリンクにアクセスする

グローバルデータリンクを作成すると、指定したメタデータが Splunk Observability Cloud の以下の関連領域に表示されます。グローバルデータリンクを作成するには管理者である必要がありますが、誰でも作成したグローバルデータリンクにアクセスできます。

データテーブル

データテーブルについては、「「データテーブル」タブを見る」を参照してください。

チャート一覧

リストチャートについては、「リストチャート」を参照してください。

アラートメッセージ

アラートに関する詳細については、「Splunk Observability Cloudでアラートを表示する」を参照してください。

Splunk Application Performance Monitoring (APM) のサービス名とトレース ID

グローバルデータリンクの使用については、「APM のサービス、トレース、スパンにリンクされた関連リソースにアクセスする」を参照してください。

次のステップ

• Splunk Application Performance Monitoring（APM）プロパティのグローバルデータリンクを作成する方法については、「APMのサービス、トレース、スパンを関連リソースにリンクする」を参照してください。

• プロパティに対して複数のデータリンクが利用可能な場合のデータリンクの動作については、「プロパティの値を選択してリンクをたどる」を参照してください。