グローバル・データリンクを使用して、メタデータを関連リソースにリンクする 🔗
グローバル・データリンクを使用すると、Splunk Observability Cloud に表示されるメタデータを以下の関連リソースにリンクできます。
Splunk Observability Cloud のダッシュボード
Splunk Cloud Platform および Splunk Enterprise
カスタムURL
Kibana ログ
Splunk RUM
Splunk Observability Cloud では、メタデータ (データに関するデータ) には ディメンション、プロパティ、タグ が含まれます。メタデータは製品の以下の場所に表示されます：
アラート
ダッシュボードと Splunk Infrastructure Monitoring ナビゲーターにあります。
チャート一覧
線グラフ
エリアチャート
カラムチャート
データテーブル
Splunk Application Performance Monitoring (APM) は以下の場所にあります。
サービス
トレース
スパン
例えば、ダッシュボードにホストプロパティのグローバルデータリンクが表示されています。グローバルデータリンクは、Splunk Observability Cloud の EC2 Cost and Usage ダッシュボードにつながり、システムは自動的にダッシュボードを絞り込み、server4 ホストに関連するデータを自動的に表示します。
グローバル・データリンクがコンテキストで表示される例については、グローバルデータリンクにアクセスする を参照してください。
グローバル・データリンクは、閲覧中のメタデータに関するコンテキスト情報をリンク先のリソースに動的に転送するため、関連情報にすばやくアクセスできます。
グローバル・データリンクを作成すると、ダッシュボード、Splunk Infrastructure Monitoring ナビゲーター、Splunk APM、アラートメッセージなど、指定したメタデータが表示されている場所であればどこにでも表示されます。メタデータを見ることができるすべてのユーザーは、グローバル・データリンクを見ることができます。
これとは対照的に、ローカルデータリンクを作成すると、作成したダッシュボードまたはナビゲーターでのみ使用できます。メタデータを見ることができるすべてのユーザーは、ローカルデータリンクを見ることができます。ローカルデータリンクの詳細については、データリンクを使用して関連リソースに移動する を参照してください。
前提条件 🔗
グローバル・データリンクを作成するには、管理者である必要があります。
管理者アクセス権の付与については、Splunk Observability Cloudでユーザーを作成および管理する を参照してください。
グローバル・データリンクの作成 🔗
この手順では、グローバル・データリンク・ページを使用して、利用可能なすべてのメタデータのグローバル・データリンクを作成する方法について説明します。
For information about how to create a global data link using the Splunk Observability Cloud API, see the Link Metadata to Related Content topic in the Splunk Observability Cloud Developer Guide.
Splunk APM プロパティのグローバル・データリンクを作成する方法については、APMのサービス、トレース、スパンを関連リソースにリンクする を参照してください。
Splunk Observability Cloud ナビゲーション メニュー を開きます。
Data Configuration にカーソルを合わせ、Global Data Links を選択します。
新しいリンク を選択します。
Link Label フィールドに、グローバル・データリンク・テキストとして表示したいテキストを入力します。
Link to フィールドで、リンク・ターゲットのタイプを選択します。グローバル・データリンクのターゲットを次の中から選択します。
カスタムURL：カスタムURLへのリンク。
Splunk：Splunk Cloud Platform または Splunk Enterprise へのリンク。
Splunk Observability Cloud Dashboard: Links to a dashboard in Splunk Observability Cloud. Select Choose Dashboard to select the dashboard you want to link to.
Kibana：Kibana のログにリンクします。
Show On リストで、グローバル・データリンクを表示する場所を示す値を選択します。
任意のメタデータ値：任意のメタデータ値のリンクを表示します。このオプションは、Link to フィールドを Splunk Observability Cloud ダッシュボード に設定した場合は使用できません。
Any Value of：特定のメタデータの任意の値のリンクを表示します。
例えば、Any Value of を選択し、aggregration_type を入力すると、aggregration_type の値のリンクが表示されます。
Property:Value Pair：特定のメタデータの特定の値のリンクを表示します。
例えば、Property:Value Pair を選択し、aggregration_type:average と入力すると、average の aggregation_type 値のリンクのみが表示されます。
Show On の値と1つ以上の追加条件に基づいてリンクを表示する場合は、Add Conditions を選択します。複数の条件を定義した場合、リンクはすべての条件が真である場合にのみ表示されます。
Any Value of と Property:Value Pair オプションの使用方法の詳細については、前の手順を参照してください。
Link to フィールドを Custom URL、Splunk、または Kibana に設定すると、URL フィールドが表示されます。グローバル・データリンク先にしたいURLを入力します。
オプションとして、Custom URL および Kibana リンク・ターゲットのタイプでは、URL に以下のプレースホルダ変数を使用できます。グローバル・データリンクを選択すると、変数が実際の値に置き換えられてリンク先URL が作成されます。
{{key}}: Use this variable to populate the key name from the context where the link displays. For example, if you set Show on to aggregation_type,aggregation_typereplaces{{key}}in the URL.{{value}}: Use this variable to populate the key value from the context where the link displays. For example, if you set Show on to aggregation_type and the aggregation_type value in context is average,averagereplaces{{value}}in the URL.{{start_time}}：この変数を使用して、リンクが表示されるコンテキストからタイムウィンドウの開始時刻を入力します。システムは、Time Format フィールドで選択したフォーマットを使用してタイムスタンプを挿入します。{{end_time}}：この変数を使用して、リンクが表示されるコンテキストからタイムウィンドウの終了時刻を入力します。システムは、Time Format フィールドで選択したフォーマットを使用してタイムスタンプを挿入します。{{properties.<property_name>}}：この変数を使用して、リンク表示のコンテキストから他のメタデータを入力します。例えば、propertiesには、グローバル・データリンク表示のコンテキストに表示されるメタデータのキー名と値のマップが格納されています。このマップから名前と値を挿入するには、{{properties.<your_property_name>}}を使用します。プロパティ名にピリオドがある場合は、値を角括弧で囲みます。例えば、{{properties.[<property.name>]}}。
If you select a Link to value of Custom URL or Kibana, the Time Format field appears. Set this field to select the timestamp format used for the global data link’s starting and ending timestamps. Setting this field also helps ensure compatibility with the external system you are linking to. Select one of the following time formats:
ISO 8601: YYYY-MM-DDThh:mm:ss.SSSZ
ユニックス時間：エポックミリ秒
ユニックス時間：エポック秒
If you select a Link to value of Custom URL, Splunk, or Kibana, the Minimum Time Window field appears. The time window is the interval during which the system captured the chart, dashboard, service map, or trace data. If this interval is shorter than the minimum time window value you select here, the global data link adjusts the start time to an earlier time so the interval is as long as the minimum time window.
Custom URL、Splunk、または Kibana の Link to 値を選択すると、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 フィールドに、マッピングする外部キー名またはキー名と値のペアを入力します。
保存 を選択します。
また、グローバルデータリンクを作成できる Splunk Observability Cloud の他の場所をいくつか紹介します。
データリンクを含むアラートメッセージを表示する場合、データリンクの横にある More メニュー(⋯)を選択し、Configure data links を選択します。
ダッシュボードで、Dashboard actions メニューから Data Links を選択します。組織に既存のグローバル・データリンクが定義されている場合は、[データリンク] タブにその旨のメッセージが表示されます。Global Data Links を選択します。
Splunk Infrastructure Monitoring ナビゲーターでリストを表示する際、任意のプロパティの Actions メニューを選択し、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}}
total メタデータ値の aggregation_type のグローバル・データリンクを選択すると、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 プロパティに固有のものですが、ガイダンスはどのプロパティにも適用できます。
グローバルデータリンクにアクセスする 🔗
グローバルデータリンクを作成すると、指定したメタデータが Splunk Observability Cloud の以下の関連領域に表示されます。グローバルデータリンクを作成するには管理者である必要がありますが、作成したグローバルデータリンクには誰でもアクセスできます。
データテーブル 🔗
データテーブルについては、「データテーブル」タブを見る を参照してください。
チャート一覧 🔗
リストチャートについては リストチャート を参照してください。
アラートメッセージ 🔗
アラートについては、Splunk Observability Cloudでアラートを表示する を参照してください。
Splunk Application Performance Monitoring (APM) のサービス名とトレース ID 🔗
Splunk APM でグローバル・データリンクにアクセスする方法の詳細については、APMのサービス、トレース、スパンにリンクされた関連リソースにアクセスする を参照してください。
次のステップ 🔗
Splunk Application Performance Monitoring (APM) プロパティのグローバル・データリンクを作成する方法については、APMのサービス、トレース、スパンを関連リソースにリンクする を参照してください。
プロパティに対して複数のデータリンクが利用可能な場合のデータリンクの動作については、プロパティの値を選択してリンクをたどる を参照してください。