Splunk コネクタ構成ガイド

構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。詳細については、コネクタについてを参照してください。

コネクタを追加した後、次の項目を構成します。

Splunk トークン：HTTP Event Collector のトークンです。Settings > Data Inputs > HTTP Event Collector でトークンを作成します。
ホスト：HTTP Event Collector を実行する Splunk インスタンスです。例：https://hec.example.com
ポート：（任意）HTTP Event Collector のポート番号です。

コネクタを構成した後、Done をクリックします。

アクション

アクション名	訪問プロファイル	イベントデータ
イベントデータ全体を送信	✗	✓
イベントデータ全体を送信（バッチ）	✗	✓
カスタムイベントデータを送信	✗	✓
カスタムイベントデータを送信（バッチ）	✗	✓
ログイベントを送信	✗	✓
イベント全体を送信	✗	✓
訪問データ全体を送信	✓	✗
訪問データ全体を送信（バッチ）	✓	✗
カスタム訪問データを送信	✓	✗
カスタム訪問データを送信（バッチ）	✓	✗

アクションの名前を入力し、Action Type を選択します。

以下のセクションでは、各アクションのパラメーターとオプションの構成方法について説明します。

イベントデータ全体を送信

メタデータ

パラメーター	説明
Splunk リクエストチャネル	インデクサー確認応答が有効な場合のチャネル識別子です。
時刻	イベントの時刻です。
ホスト	イベントデータに割り当てるホスト値です。
ソース	イベントデータに割り当てるソース値です。たとえば、開発中のアプリからデータを送信する場合は、このキーをアプリ名に構成します。
ソースタイプ	イベントデータに割り当てるソースタイプの値です。
インデックス	イベントデータのインデックス作成に使用するインデックスの名前です。トークンに indexes パラメーターが構成されている場合、ここで指定するインデックスは、許可されているインデックスのリストに含まれている必要があります。
カスタムフィールド	fields キーは生データには適用されません。このキーでは、インデックス作成時に定義する明示的なカスタムフィールドのフラットな（ネストされていない）リストを含む JSON オブジェクトを指定します。`fields` プロパティを含むリクエストは、`/collector/event` エンドポイントに送信する必要があります。それ以外の場合、インデックスは作成されません。詳細については、Splunk Enterprise：HTTP Event Collector を使用したインデックス付きフィールド抽出の自動化を参照してください。
属性名を出力	属性名が更新された場合、ペイロード内の名前にも更新が反映されます。

イベントデータ全体を送信（バッチ）

バッチの制限

このアクションでは、ベンダーへの大量データ転送に対応するため、バッチリクエストを使用します。並列処理により、イベントが順不同でベンダーに到達する場合があります。順序が重要な場合は、イベントにシーケンス値を追加してください。詳細については、バッチアクションを参照してください。次のいずれかのしきい値に達するか、プロファイルがパブリッシュされるまで、リクエストはキューに格納されます。

リクエストの最大数：100,000
最も古いリクエストからの最大経過時間：60 分
リクエストの最大サイズ：10 MB

メタデータ

パラメーター	説明
Splunk リクエストチャネル	インデクサー確認応答が有効な場合のチャネル識別子です。
時刻	イベントの時刻です。
ホスト	イベントデータに割り当てるホスト値です。
ソース	イベントデータに割り当てるソース値です。たとえば、開発中のアプリからデータを送信する場合は、このキーをアプリ名に構成します。
ソースタイプ	イベントデータに割り当てるソースタイプの値です。
インデックス	イベントデータのインデックス作成に使用するインデックスの名前です。トークンに indexes パラメーターが構成されている場合、ここで指定するインデックスは、許可されているインデックスのリストに含まれている必要があります。
カスタムフィールド	fields キーは生データには適用されません。このキーでは、インデックス作成時に定義する明示的なカスタムフィールドのフラットな（ネストされていない）リストを含む JSON オブジェクトを指定します。`fields` プロパティを含むリクエストは、`/collector/event` エンドポイントに送信する必要があります。それ以外の場合、インデックスは作成されません。詳細については、Splunk Enterprise：HTTP Event Collector を使用したインデックス付きフィールド抽出の自動化を参照してください。
属性名を出力	属性名が更新された場合、ペイロード内の名前にも更新が反映されます。
バッチの有効期間	バッチアクションを送信する頻度を指定するため、有効期間（TTL）を構成します。`1`～`60` 分の値を入力します。デフォルトは `15` 分です。

カスタムイベントデータを送信

メタデータ

パラメーター	説明
Splunk リクエストチャネル	インデクサー確認応答が有効な場合のチャネル識別子です。
時刻	イベントの時刻です。
ホスト	イベントデータに割り当てるホスト値です。
ソース	イベントデータに割り当てるソース値です。たとえば、開発中のアプリからデータを送信する場合は、このキーをアプリ名に構成します。
ソースタイプ	イベントデータに割り当てるソースタイプの値です。
インデックス	イベントデータのインデックス作成に使用するインデックスの名前です。トークンに indexes パラメーターが構成されている場合、ここで指定するインデックスは、許可されているインデックスのリストに含まれている必要があります。
カスタムフィールド	fields キーは生データには適用されません。このキーでは、インデックス作成時に定義する明示的なカスタムフィールドのフラットな（ネストされていない）リストを含む JSON オブジェクトを指定します。`fields` プロパティを含むリクエストは、`/collector/event` エンドポイントに送信する必要があります。それ以外の場合、インデックスは作成されません。詳細については、Splunk Enterprise：HTTP Event Collector を使用したインデックス付きフィールド抽出の自動化を参照してください。

メッセージデータ

パラメーター	説明
カスタムメッセージ定義	メッセージデータを構築するための値を指定します。テンプレートを使用する場合は、テンプレート名を参照して、そのテンプレートからメッセージデータを生成します。テンプレートを使用する場合は、カスタムメッセージ定義にマッピングします。テンプレートを使用すると、その他のキーと値のペアは無視されます。
テンプレート変数	（任意）テンプレートへのデータ入力としてテンプレート変数を指定します。詳細については、コネクターテンプレート変数を参照してください。ネストされたテンプレート変数には、ドット表記で名前を付けます。例：`items.name` ネストされたテンプレート変数は通常、データレイヤーのリスト属性から構築されます。
テンプレート	（任意）URL、URL パラメーター、ヘッダー、または本文データで参照するテンプレートを指定します。詳細については、コネクタテンプレートについてを参照してください。テンプレートは、二重波括弧で囲んだ名前を使用して、サポート対象のフィールドに挿入されます。例：`{{SomeTemplateName}}`

カスタムイベントデータを送信（バッチ）

バッチの制限

リクエストの最大数：100,000
最も古いリクエストからの最大経過時間：60 分
リクエストの最大サイズ：10 MB

メタデータ

パラメーター	説明
Splunkリクエストチャネル	インデクサー確認応答が有効な場合のチャネル識別子。
時刻	イベントの時刻。
ホスト	イベントデータに割り当てるホスト値。
ソース	イベントデータに割り当てるソース値。たとえば、開発中のアプリからデータを送信する場合は、このキーをアプリの名前に構成します。
ソースタイプ	イベントデータに割り当てるソースタイプの値。
インデックス	イベントデータのインデックス作成に使用するインデックスの名前。トークンにindexesパラメーターが構成されている場合、ここで指定するインデックスは許可されたインデックスのリストに含まれている必要があります。
カスタムフィールド	fieldsキーは生データには適用されません。このキーには、インデックス作成時に定義する明示的なカスタムフィールドのフラットな（ネストされていない）リストを含むJSONオブジェクトを指定します。`fields`プロパティを含むリクエストは、`/collector/event`エンドポイントに送信する必要があります。それ以外の場合、それらはインデックス化されません。詳細については、Splunk Enterprise：HTTP Event Collectorによるインデックスフィールド抽出の自動化を参照してください。

メッセージデータ

パラメーター	説明
カスタムメッセージ定義	メッセージデータを構築するための値を指定します。テンプレートを使用する場合は、テンプレートからメッセージデータを生成するためにテンプレート名を参照します。テンプレートを使用する場合は、それをカスタムメッセージ定義にマッピングします。テンプレートが使用される場合、その他のキーと値のペアは無視されます。
テンプレート変数	（オプション）テンプレートへのデータ入力としてテンプレート変数を指定します。詳細については、コネクターテンプレート変数を参照してください。ネストされたテンプレート変数にはドット表記で名前を付けます。例：`items.name` ネストされたテンプレート変数は通常、データレイヤーのリスト属性から構築されます。
テンプレート	（オプション）URL、URLパラメーター、ヘッダー、または本文データで参照するテンプレートを指定します。詳細については、コネクタテンプレートについてを参照してください。テンプレートは、二重波括弧を使用し、名前によってサポート対象フィールドに挿入されます。例：`{{SomeTemplateName}}`。
バッチの有効期間	バッチアクションを送信する頻度を指定するため、有効期間（TTL）を構成します。`1`～`60`分の値を入力します。デフォルトは`15`分です。

訪問データ全体の送信

メタデータ

パラメーター	説明
Splunkリクエストチャネル	インデクサー確認応答が有効な場合のチャネル識別子。
時刻	イベントの時刻。
ホスト	イベントデータに割り当てるホスト値。
ソース	イベントデータに割り当てるソース値。たとえば、開発中のアプリからデータを送信する場合は、このキーをアプリの名前に構成します。
ソースタイプ	イベントデータに割り当てるソースタイプの値。
インデックス	イベントデータのインデックス作成に使用するインデックスの名前。トークンにindexesパラメーターが構成されている場合、ここで指定するインデックスは許可されたインデックスのリストに含まれている必要があります。
カスタムフィールド	fieldsキーは生データには適用されません。このキーには、インデックス作成時に定義する明示的なカスタムフィールドのフラットな（ネストされていない）リストを含むJSONオブジェクトを指定します。`fields`プロパティを含むリクエストは、`/collector/event`エンドポイントに送信する必要があります。それ以外の場合、それらはインデックス化されません。詳細については、Splunk Enterprise：HTTP Event Collectorによるインデックスフィールド抽出の自動化を参照してください。
現在の訪問データを訪問データに含める	現在の訪問データをペイロードに追加します。［現在の訪問のイベントデータを除外］が選択されていない限り、これには訪問のイベントデータが含まれます。
現在の訪問のイベントデータを除外	現在の訪問データからイベントデータを除外します。
属性名を出力	属性名が更新された場合、ペイロード内の名前にその更新が反映されます。

訪問データ全体の送信（バッチ）

バッチ制限

このアクションでは、ベンダーへの大量のデータ転送をサポートするため、バッチリクエストを使用します。並列処理により、イベントが順不同でベンダーに到達する可能性があります。順序が重要な場合は、イベントにシーケンス値を追加してください。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかのしきい値に達するか、プロファイルがパブリッシュされるまでキューに格納されます。

リクエストの最大数：100,000
最も古いリクエストからの最大経過時間：60分
リクエストの最大サイズ：10 MB

メタデータ

パラメーター	説明
Splunkリクエストチャネル	インデクサー確認応答が有効な場合のチャネル識別子。
時刻	イベントの時刻。
ホスト	イベントデータに割り当てるホスト値。
ソース	イベントデータに割り当てるソース値。たとえば、開発中のアプリからデータを送信する場合は、このキーをアプリの名前に構成します。
ソースタイプ	イベントデータに割り当てるソースタイプの値。
インデックス	イベントデータのインデックス作成に使用するインデックスの名前。トークンにindexesパラメーターが構成されている場合、ここで指定するインデックスは許可されたインデックスのリストに含まれている必要があります。
カスタムフィールド	fieldsキーは生データには適用されません。このキーには、インデックス作成時に定義する明示的なカスタムフィールドのフラットな（ネストされていない）リストを含むJSONオブジェクトを指定します。`fields`プロパティを含むリクエストは、`/collector/event`エンドポイントに送信する必要があります。それ以外の場合、それらはインデックス化されません。詳細については、Splunk Enterprise：HTTP Event Collectorによるインデックスフィールド抽出の自動化を参照してください。
現在の訪問のイベントデータを除外	現在の訪問データからイベントデータを除外します。
属性名を出力	属性名が更新された場合、ペイロード内の名前にその更新が反映されます。
バッチの有効期間	バッチアクションを送信する頻度を指定するため、有効期間（TTL）を構成します。`1`～`60`分の値を入力します。デフォルトは`15`分です。

カスタム訪問データの送信

メタデータ

パラメーター	説明
Splunkリクエストチャネル	インデクサー確認応答が有効な場合のチャネル識別子。
時刻	イベントの時刻。
ホスト	イベントデータに割り当てるホスト値。
ソース	イベントデータに割り当てるソース値。たとえば、開発中のアプリからデータを送信する場合は、このキーをアプリの名前に構成します。
ソースタイプ	イベントデータに割り当てるソースタイプの値。
インデックス	イベントデータのインデックス作成に使用するインデックスの名前。トークンにindexesパラメーターが構成されている場合、ここで指定するインデックスは許可されたインデックスのリストに含まれている必要があります。
カスタムフィールド	fieldsキーは生データには適用されません。このキーには、インデックス作成時に定義する明示的なカスタムフィールドのフラットな（ネストされていない）リストを含むJSONオブジェクトを指定します。`fields`プロパティを含むリクエストは、`/collector/event`エンドポイントに送信する必要があります。それ以外の場合、それらはインデックス化されません。詳細については、Splunk Enterprise：HTTP Event Collectorによるインデックスフィールド抽出の自動化を参照してください。

メッセージデータ

パラメーター	説明
カスタムメッセージ定義	メッセージデータを構築するための値を指定します。テンプレートをサポートするには、テンプレートからメッセージデータを生成するためにテンプレート名を参照します。テンプレートを使用する場合は、カスタムメッセージ定義にマッピングします。テンプレートを使用すると、その他のキーと値のペアは無視されます。
テンプレート変数	（任意）テンプレートへのデータ入力としてテンプレート変数を指定します。詳しくは、コネクターテンプレート変数を参照してください。ネストされたテンプレート変数にはドット表記で名前を付けます。例：`items.name` ネストされたテンプレート変数は通常、データレイヤーのリスト属性から構築されます。
テンプレート	（任意）URL、URL パラメーター、ヘッダー、または本文データで参照するテンプレートを指定します。詳しくは、コネクタテンプレートについてを参照してください。テンプレートは、二重中括弧で囲んだ名前によって、サポートされているフィールドに挿入されます。例：`{{SomeTemplateName}}`。

カスタム訪問データを送信（バッチ）

バッチの制限

このアクションでは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。並列処理により、イベントが順不同でベンダーに到達する場合があります。順序が重要な場合は、イベントにシーケンス値を追加してください。詳しくは、バッチアクションを参照してください。次のいずれかのしきい値に達するか、プロファイルがパブリッシュされるまで、リクエストはキューに格納されます。

リクエストの最大数：100,000
最も古いリクエストからの最大経過時間：60 分
リクエストの最大サイズ：10 MB

メタデータ

パラメーター	説明
Splunk リクエストチャネル	インデクサー確認応答が有効な場合のチャネル識別子。
時刻	イベント時刻。
ホスト	イベントデータに割り当てるホスト値。
ソース	イベントデータに割り当てるソース値。たとえば、開発中のアプリからデータを送信する場合は、このキーをアプリ名に構成します。
ソースタイプ	イベントデータに割り当てるソースタイプ値。
インデックス	イベントデータのインデックス作成に使用するインデックスの名前。トークンに indexes パラメーターが構成されている場合、ここで指定するインデックスは許可されたインデックスのリストに含まれている必要があります。
カスタムフィールド	fields キーは生データには適用されません。このキーでは、インデックス作成時に定義する明示的なカスタムフィールドのフラットな（ネストされていない）リストを含む JSON オブジェクトを指定します。`fields`プロパティを含むリクエストは、`/collector/event`エンドポイントに送信する必要があります。それ以外の場合、リクエストはインデックス化されません。詳しくは、Splunk Enterprise：HTTP Event Collector を使用したインデックスフィールド抽出の自動化を参照してください。

メッセージデータ

パラメーター	説明
カスタムメッセージ定義	メッセージデータを構築するための値を指定します。テンプレートをサポートするには、テンプレートからメッセージデータを生成するためにテンプレート名を参照します。テンプレートを使用する場合は、カスタムメッセージ定義にマッピングします。テンプレートを使用すると、その他のキーと値のペアは無視されます。
テンプレート変数	（任意）テンプレートへのデータ入力としてテンプレート変数を指定します。詳しくは、コネクターテンプレート変数を参照してください。ネストされたテンプレート変数にはドット表記で名前を付けます。例：`items.name` ネストされたテンプレート変数は通常、データレイヤーのリスト属性から構築されます。
テンプレート	（任意）URL、URL パラメーター、ヘッダー、または本文データで参照するテンプレートを指定します。詳しくは、コネクタテンプレートについてを参照してください。テンプレートは、二重中括弧で囲んだ名前によって、サポートされているフィールドに挿入されます。例：`{{SomeTemplateName}}`。
バッチの有効期間	バッチアクションを送信する頻度を指定するため、有効期間（TTL）を構成します。`1`～`60`分の値を入力します。デフォルトは`15`分です。

ログイベントを送信

メタデータ

パラメーター	説明
Splunk リクエストチャネル	インデクサー確認応答が有効な場合のチャネル識別子。
時刻	イベント時刻。
ホスト	イベントデータに割り当てるホスト値。
ソース	イベントデータに割り当てるソース値。たとえば、開発中のアプリからデータを送信する場合は、このキーをアプリ名に構成します。
ソースタイプ	イベントデータに割り当てるソースタイプ値。
インデックス	イベントデータのインデックス作成に使用するインデックスの名前。トークンに indexes パラメーターが構成されている場合、ここで指定するインデックスは許可されたインデックスのリストに含まれている必要があります。
カスタムフィールド	fields キーは生データには適用されません。このキーでは、インデックス作成時に定義する明示的なカスタムフィールドのフラットな（ネストされていない）リストを含む JSON オブジェクトを指定します。`fields`プロパティを含むリクエストは、`/collector/event`エンドポイントに送信する必要があります。それ以外の場合、リクエストはインデックス化されません。詳しくは、Splunk Enterprise：HTTP Event Collector を使用したインデックスフィールド抽出の自動化を参照してください。

メッセージデータ

パラメーター	説明
カスタムメッセージ定義	メッセージデータを構築するための値を指定します。テンプレートをサポートするには、テンプレートからメッセージデータを生成するためにテンプレート名を参照します。テンプレートを使用する場合は、カスタムメッセージ定義にマッピングします。テンプレートを使用すると、その他のキーと値のペアは無視されます。
テンプレート変数	（任意）テンプレートへのデータ入力としてテンプレート変数を指定します。詳しくは、コネクターテンプレート変数を参照してください。ネストされたテンプレート変数にはドット表記で名前を付けます。例：`items.name`。ネストされたテンプレート変数は通常、データレイヤーのリスト属性から構築されます。
テンプレート	（任意）URL、URL パラメーター、ヘッダー、または本文データで参照するテンプレートを指定します。詳しくは、コネクタテンプレートについてを参照してください。テンプレートは、二重中括弧で囲んだ名前によって、サポートされているフィールドに挿入されます。例：`{{SomeTemplateName}}`。

ログイベント全体を送信

メタデータ

パラメーター	説明
Splunk リクエストチャネル	インデクサー確認応答が有効な場合のチャネル識別子。
時刻	イベント時刻。
ホスト	イベントデータに割り当てるホスト値。
ソース	イベントデータに割り当てるソース値。たとえば、開発中のアプリからデータを送信する場合は、このキーをアプリ名に構成します。
ソースタイプ	イベントデータに割り当てるソースタイプ値。
インデックス	イベントデータのインデックス作成に使用するインデックスの名前。トークンに indexes パラメーターが構成されている場合、ここで指定するインデックスは許可されたインデックスのリストに含まれている必要があります。
カスタムフィールド	fields キーは生データには適用されません。このキーでは、インデックス作成時に定義する明示的なカスタムフィールドのフラットな（ネストされていない）リストを含む JSON オブジェクトを指定します。`fields`プロパティを含むリクエストは、`/collector/event`エンドポイントに送信する必要があります。それ以外の場合、リクエストはインデックス化されません。詳しくは、Splunk Enterprise：HTTP Event Collector を使用したインデックスフィールド抽出の自動化を参照してください。