ログストリーミングについて

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

概要

ログストリーミングはTealiumのログを既存の監視、保存、およびアラートプラットフォームにルーティングし、既に使用しているツールでシステムの動作を監視できます。

このアーリーアクセスリリースでは、ログストリーミングはコネクタエラーログをサポートしています。

ログストリーミングを使用して：

• 中央の場所でコネクタの信頼性を監視します。
• 詳細なログレコードで障害を調査します。
• 送信先プラットフォームでダッシュボードやアラートを構築します。
• 保持またはコンプライアンスのニーズに対応するために、自分のシステムにログを保存します。

動作原理

ログストリーミングは主に2つのコンポーネントを使用します：

送信先

送信先はログエントリが送信される場所を定義します。各送信先はコネクタによってバックアップされ、専用のログストリーミングアクションを使用してログデータを外部システムに配信します。

ログストリーミングの送信先はログストリーミングUIで構成され、標準コネクタ画面で構成されたコネクタとは別です。

例には、DatadogやNew Relicのような監視プラットフォーム、Amazon S3のような保存システム、Confluent Kafkaのようなストリーミングプラットフォームが含まれます。さらに多くの例については、#available-destination-connectorsを参照してください。

ログソース

ログソースは、どのログが収集され、配信前にどのようにグループ化されるかを定義します。各ログソースはログタイプを指定し、どのコネクタまたはアクションが監視されるかを制御します。ログソースインスタンスは単一の送信先に紐づけられます。同じログを複数の送信先に送信するには、別々のログソースインスタンスを作成します。

ログソースがログエントリを生成すると、次のプロセスが発生します：

1. ログソースがイベントをキャプチャします。
2. ログソースは、コネクタタイプ、HTTPレスポンスステータス、エラーコード、実行時間などのフィールドを含む構造化されたレコードを組み立てます。
3. レコードは関連する送信先に転送されます。
4. 送信先コネクタがログエントリを外部プラットフォームに配信します。
5. 外部プラットフォームがログを監視、分析、アラート、または長期保持のために取り込みます。

例えば、高優先度のキャンペーンのコネクタエラーを監視し、それらのログをDatadogに送信して、チームが障害を確認し、エラー数が増加したときにアラートをトリガーすることができます。

ログストリーミングはコネクタを通じてログを配信し、Tealium内でログを保存または分析しません。

利点

• コネクタエラーに関する外部からの可視性
  コネクタエラー情報は通常、Tealium UI内でのみ利用可能です。ログストリーミングはそれらのエラーを監視スタックにルーティングするため、Tealiumにログインせずにチームがそれらを監視できます。
• プログラムによる分析のための構造化データ
  各ログレコードには、HTTPステータスコード、エラータイプ、実行時間などのフィールドが含まれます。これらのフィールドを使用してエラーを分類し、ノイズをフィルタリングし、送信先プラットフォームでターゲットを絞ったアラートを構築します。
• 相関監視
  Tealiumの障害を、インフラの残りの部分を監視している同じプラットフォームに送信することで、より広範なシステムイベントとTealiumの障害を相関させることができます。
• 長期的なエラー履歴
  Tealiumは歴史的なエラーデータを保持しません。ログを自分のシステムに保存することで、監査、コンプライアンス、またはトレンド分析のための永続的な記録を持つことができます。
• 選択的なフィールド配信
  送信先に到達するフィールドを制御するために、Send Log Eventアクションを使用して、使用ケースに関連するものだけを転送します。

利用可能な送信先コネクタ

ログエントリを送信するために以下のコネクタを使用します：

各送信先は2つのログストリーミングアクションのいずれかを使用します：

• Send Entire Log Event
  利用可能なすべてのログ属性を単一のペイロードで送信先に送信します。初期構成中に完全なデータ構造を確認し、使用ケースに関連するフィールドを特定するためにこのアクションを使用します。
• Send Log Event
  コネクタアクション構成で明示的にマッピングした属性のみを送信します。ペイロードにはマッピングされた属性のみが含まれます。本番環境で送信先に到達するフィールドを制御するためにこのアクションを使用します。詳細については、Map event attributes to vendor parametersを参照してください。

利用可能なログソース

以下のログソースタイプがサポートされています：

• Connector Errors
  コネクタアクションによって生成されるエラーログ。これらのログには、エラーコード、実行ステータス、タイムスタンプ、トラブルシューティングに使用される識別子などの詳細が含まれます。

ワークフロー

始める前に、監視するコネクタとアクション、ログを受け取る外部プラットフォームを決定します。

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

1. Create a destination 各外部システムがログを受け取るための送信先を作成します。
2. Create a log source 監視するコネクタとアクションを定義するログソースを作成します。
3. Map event attributes to vendor parameters ログフィールド値を抽出するためのエンリッチメントを作成し、それらの属性を送信先固有のパラメータにマッピングします。
4. 正しくマッピングされたフィールドでログレコードが送信先システムに到着することを確認します。
5. Monitor log streaming activity Manage Log Streamingページを使用してログストリーミング活動を監視します。配信メトリックはログ配信パイプラインの健全性を反映し、監視されているコネクタ操作ではありません。

ログでキャプチャされたコネクタエラーのトラブルシューティングについては、Connector error loggingを参照してください。

次のステップ

• Manage log streaming
• Connector error logging