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

ログストリーミングはEarly Access中で、選ばれた顧客のみが利用可能です。この機能を試してみたい場合は、Tealiumサポート担当者に連絡してください。

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

Server-Side Settings > Log Streamingに移動します。
Enable Log Streamingをオンにします。
プロファイルを保存して公開します。

送信先を作成する

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

例えば：

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

送信先を作成するには：

管理メニューでManage Log Streamingをクリックします。
+ New Destinationをクリックします。
コネクタを選択してNextをクリックします。
Statusをオンにして送信先を有効にします。
送信先のNameを入力します。
（オプション）送信先の説明としてNotesを入力します。
認証と接続構成を構成します。必要なフィールドは選択したコネクタによって異なります。
Test Connectionをクリックして接続を確認します。
Doneをクリックします。

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

ログソースを作成する

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

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

次のいずれかを使用してログソースダイアログを開きます：
- Manage Log Streamingテーブルから、送信先行で**+ New Source**をクリックします。
- 送信先を選択し、+ New Sourceをクリックします。
New Log Sourceダイアログで：
1. Log Source Nameを入力します。
2. Log Streaming Scopeを選択します：
  - Send Entire Log Event：ペイロードのすべてのログ属性を送信します。
  - Send Log Event：ペイロードのマップされた属性のみを送信します。
  利用可能なオプションが一つのみの場合、それがデフォルトで選択されます。詳細については、Available destination connectorsを参照してください。
3. Log Source TypeはConnector Errorsに構成されます。
4. 右側のサンプルペイロードを確認して、利用可能なフィールドを理解します。
5. Continueをクリックします。
監視するコネクタを選択します：
1. リストから一つ以上のコネクタを選択します。
2. ログに記録する内容を絞り込むには、コネクタでSelect Action Logsをクリックします。
アクションレベルのログ記録を構成します（オプション）：
1. Select Actions to Logダイアログで、Log Streaming Modeを選択します：
  - Send All（コネクタレベルのログ記録）コネクタのすべてのアクションのエラーログを送信します。後で追加されたアクションも含まれます。
  - Send Selected Actions（アクションレベルのログ記録）選択したアクションのみのログを送信します。
2. Send Selected Actionsを使用する場合、監視するアクションを選択します。
3. Doneをクリックします。
コネクタの選択を保存するためにDoneをクリックします。

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

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

利用可能なベンダーパラメータについての情報は、destination connector and actionおよびconnector log parametersのドキュメントを参照してください。

マッピングの仕組み

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

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

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

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

例えば、重大度レベルをマッピング可能にするために：
- dd_severityという名前の文字列イベント属性を作成します。
- 値として{{severityText}}を持つ文字列構成エンリッチメントを追加します。
配信時に、エンリッチメントはログレコードから値を抽出してイベント属性に書き込みます。

利用可能なログパラメータの完全なリストについては、Connector log parametersを参照してください。
イベント属性をベンダーパラメータにマッピングする

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

例えば、DatadogのSend Log Eventログソース構成で、イベント属性dd_severityをDatadogのSeverityパラメータにマッピングします。

マッピング例（Datadog）

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

イベント属性	文字列構成エンリッチメント
`dd_tags`	`account:{{account}},profile:{{profile}},connector:{{connectorType}},action_id:{{customId}},status:{{result.status}},error_code:{{result.failure.code.name}},http_status:{{http.0.response.statusCode}},group_id:{{groupId}}`
`dd_subject`	`{{result.failure.code.name}}`
`dd_content`	`{{result.failure.error.0.message}}`
`dd_severity`	`{{severityText}}`

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

イベント属性	ベンダーパラメータ
`tealium_connector_errors`	DD Source
`dd_tags`	DD Tags
`tealium_server_side`	Hostname
`tealium_connectors`	Service
`tealium_timestamp_epoch`	Timestamp
`dd_subject`	Subject
`dd_content`	Content
`dd_severity`	Severity

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

完全なパラメータ定義については、Connector log parametersを参照してください。

配信を確認する

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

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

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

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

Manage Log Streamingページを使用して、配信パフォーマンスを監視し、送信先を管理します。

概要メトリック

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

Total Volume：送信されたログイベントの数
Retries：再試行の回数
Total Success：正常に配信されたイベント
Success after Retry：一回以上の再試行後に配信されたイベント
Total Errors：配信に失敗したイベント

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

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

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

宛先テーブル

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

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

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

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

宛先の詳細を表示

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

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

ログソースの詳細を表示

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

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

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

マッピングのコピー

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

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

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