ログストリーミングの管理

ログストリーミングを有効にする

1. サーバーサイド構成 > ログストリーミングに移動します。
2. ログストリーミングを有効にするをオンにします。
3. プロファイルを保存して公開します。

送信先を作成する

ログを受け取る各外部システムに対して一つの送信先を作成します。

例えば：

• モニタリングとアラート用にDatadog送信先を作成します。
• 長期保存と監査用にAmazon S3送信先を作成します。

送信先を作成するには：

1. 管理メニューでログストリーミングの管理をクリックします。
2. + 新しい送信先をクリックします。
3. コネクタを選択して次へをクリックします。
4. ステータスをオンにして送信先を有効にします。
5. 送信先の名前を入力します。
6. （オプション）送信先の説明としてノートを入力します。
7. 認証と接続構成を構成します。必要なフィールドは選択したコネクタによって異なります。
8. 接続テストをクリックして接続性を確認します。
9. 完了をクリックします。

各送信先には独自の構成要件があります。必要なフィールドとサポートされているパラメータについては、コネクタのドキュメントを参照してください。利用可能なコネクタのリストについては、利用可能な送信先コネクタを参照してください。

ログソースを作成する

ログストリーミングは、アウトバウンドイベントコネクタコールにカウントされます。使用事例に必要なコネクタとアクションのみを監視してください。

ログソースを作成するには：

1. 次のいずれかを使用してログソースダイアログを開きます：

   • ログストリーミングの管理テーブルから、送信先行で**+ 新しいソース**をクリックします。
   • 送信先を選択し、+ 新しいソースをクリックします。

2. 新しいログソースダイアログで：

   1. ログソース名を入力します。

   2. ログストリーミングの範囲を選択します：

      • 全ログイベントを送信：ペイロード内のすべてのログ属性を送信します。
      • ログイベントを送信：ペイロード内のマップされた属性のみを送信します。

      利用可能なオプションが一つのみの場合、それがデフォルトで選択されます。詳細については、利用可能な送信先コネクタを参照してください。

   3. ログソースタイプはコネクタエラーに構成されます。

   4. 右側のサンプルペイロードを確認して、利用可能なフィールドを理解します。

   5. 続けるをクリックします。

3. 監視するコネクタを選択します：

   1. リストから一つ以上のコネクタを選択します。
   2. ログされる内容を絞り込むには、コネクタのアクションログを選択をクリックします。

4. アクションレベルのログ構成（オプション）：

   1. ログアクションを選択ダイアログで、ログストリーミングモードを選択します：
      • すべて送信（コネクタレベルのログ） コネクタのすべてのアクションのエラーログを送信します。後で追加されたアクションも含まれます。
      • 選択したアクションを送信（アクションレベルのログ） 選択したアクションのログのみを送信します。
   2. 選択したアクションを送信を使用する場合、監視するアクションを選択します。
   3. 完了をクリックします。

5. コネクタの選択を保存するために完了をクリックします。

イベント属性をベンダーパラメータにマッピングする

ログソースを構成した後、Tealiumのログ属性を送信先システムで必要とされるパラメータにマッピングします。ログソースの構成タブで行います。

利用可能なベンダーパラメータについての情報は、送信先コネクタとアクションおよびコネクタログパラメータのドキュメントを参照してください。

マッピングの仕組み

ログストリーミングは標準のイベント処理とは別のパイプラインで実行されます。訪問やイベントデータからの通常のイベント属性はログストリーミングアクションで利用できません。このため、ログパラメータの値はイベント属性に明示的に昇格させる必要があります。その後、それらを送信先のフィールドにマッピングできます。

マッピングには二つのステップがあります：

1. イベント属性を使用してエンリッチメントを作成する

   送信先に送りたい各ログフィールドに対して文字列イベント属性を作成します。その属性にログパラメータを値として持つ文字列構成エンリッチメントを追加します。二重中括弧を使用します。

   例えば、重要度レベルをマッピング可能にするために：

   • dd_severityという名前の文字列イベント属性を作成します。
   • 値として{{severityText}}を持つ文字列構成エンリッチメントを追加します。

   配信時に、エンリッチメントはログレコードから値を抽出してイベント属性に書き込みます。

   利用可能なログパラメータの完全なリストについては、コネクタログパラメータを参照してください。

2. イベント属性をベンダーパラメータにマッピングする

   ログソースの構成で、イベント属性を適切なベンダーパラメータにマッピングします。利用可能なパラメータは使用している送信先コネクタに依存します。

   例えば、Datadogのログイベントを送信ログソース構成で、イベント属性dd_severityをDatadogの重要度パラメータにマッピングします。

マッピング例（Datadog）

以下の例は、Datadog送信先の属性構造を示しています：

その後、これらのイベント属性をログソースの構成タブでベンダーパラメータにマッピングします：

ログソースビューのサンプルペイロードを使用して、参照しているフィールドが存在し、期待される値を含んでいることを確認します。

完全なパラメータ定義については、コネクタログパラメータを参照してください。

配信を確認する

送信先とログソースを構成した後：

• ログが送信先システムに到着していることを確認します。
• フィールドが正しくマッピングされているかを検証します。
• フィールドが欠落している場合や誤ってフォーマットされている場合は、マッピングを調整します。

Tealiumでは、ログストリーミングダッシュボードを使用して、ログが正常に送信されていることを確認します。

ログストリーミング活動を監視する

ログストリーミングの管理ページを使用して、配信パフォーマンスを監視し、送信先を管理します。

概要メトリック

概要セクションでは、選択した時間範囲の配信メトリックを表示します。

• 総ボリューム：送信されたログイベントの数
• リトライ：リトライ試行の数
• 総成功：正常に配信されたイベント
• リトライ後の成功：一回以上のリトライ後に配信されたイベント
• 総エラー：配信に失敗したイベント

これらのメトリックは、コネクタの実行ではなく、ログ配信パイプラインの健全性を反映しています。

高いエラー数は通常、以下のような問題を示しています：

• 認証の失敗
• 接続問題
• 送信先の構成エラー

宛先テーブル

ログストリーミング宛先テーブルは、構成されたすべての宛先とその配信パフォーマンスを一覧表示します。

各行には以下が表示されます：

• ソース: 宛先に接続されたログソースの数
• 総ボリューム / 成功 / エラー: 宛先の配信メトリクス
• 更新日: 宛先が最後に更新された日時
• ラベル: 宛先に適用されたラベル
• ステータス: 宛先がアクティブかどうか

このテーブルを使用して、ボリュームやエラーに異常なパターンを特定し、さらに調査するための宛先を選択します。

宛先の詳細を表示

宛先を選択してその詳細を開きます。以下のタブを使用します：

• 概要: 配信トレンドチャート、要約統計、および基本情報（名前、メモ、UID、ラベル）。統計とトレンドチャートをフィルタリングするための期間を選択します。
• ログソース: この宛先に接続されたログソース、タイプ、ステータス、および各ソースの統計（総ボリューム、成功、エラー）。個々のソースを複製または削除するオプションが含まれます。
• 構成: コネクタ構成（認証フィールド、ID、接続パラメータ）

ログソースの詳細を表示

ログソースを選択してその詳細を開きます。以下のタブを使用します：

• 概要: 配信トレンドチャートと要約統計。統計をフィルタリングするための期間を選択します。
• コネクタ: このログソースによって監視されるコネクタとアクション。
• 構成: 属性マッピングとサンプルペイロード。ログソース間でマッピングを再利用するには、マッピングのコピーを参照してください。

サンプルペイロードを使用して、マッピングで参照するフィールドが存在し、期待される値を含んでいることを確認します。

マッピングのコピー

マッピングのコピーを使用して、ログソース間で構成を再利用します。

1. ログソースを開きます。
2. 構成タブに移動します。
3. マッピングのコピーをクリックします。
4. 次のいずれかを選択します：
   • アクションからマッピングを挿入: 選択したアクションから現在のアクションにマッピングをコピーします。
   • アクションへマッピングをコピー: 現在のアクションから選択したアクションにマッピングをコピーします。
5. 競合の取り扱い方法を選択します：
   • 元のマッピングを保持: ソースからの新しいマッピングを追加し、宛先の既存のマッピングは変更しません。
   • すべてのマッピングを上書き: 宛先のすべての既存のマッピングをソースアクションからのものに置き換えます。
6. アクションのリストを絞り込むためにフィルターを適用するか、検索を行い、アクションを選択します。
7. 完了をクリックします。

同じログソースを複数の宛先に送信したい場合は、追加の宛先を作成し、ログソースを追加してから、マッピングのコピー オプションを使用して、あるログソースから他のログソースへマッピングを複製します。

関連リソース

• コネクタエラーログ
• エンリッチメントについて
• ログストリーミングについて