バージョンメタデータ

バージョンメタデータバインディングは、Workersランタイム内からバージョンに関連付けられたメタデータにアクセスするために使用できます。

WorkerのバージョンID、バージョンタグ、およびバージョンが作成された時刻のタイムスタンプは、バージョンメタデータバインディングを通じて利用可能です。これらは、Workers Analytics Engineや、Workerバージョンで集約するための任意のサードパーティの分析/メトリクスサービスに送信されるイベントで使用できます。

バージョンメタデータバインディングを使用するには、Workerのwrangler.tomlファイルを更新します：

wrangler.toml

[version_metadata]
binding = "CF_VERSION_METADATA"

インターフェース

Worker内からバージョンIDとバージョンタグにアクセスして、Workers Analytics Engineにイベントを送信する方法の例：

JavaScript

export default {
  async fetch(request, env, ctx) {
    const { id: versionId, tag: versionTag, timestamp: versionTimestamp } = env.CF_VERSION_METADATA;
    env.WAE.writeDataPoint({
      indexes: [versionId],
      blobs: [versionTag, versionTimestamp],
      //...
    });
    //...
  },
};

TypeScript

interface Environment {
  CF_VERSION_METADATA: WorkerVersionMetadata;
  WAE: AnalyticsEngineDataset;
}

export default {
  async fetch(request, env, ctx) {
    const { id: versionId, tag: versionTag } = env.CF_VERSION_METADATA;
    env.WAE.writeDataPoint({
      indexes: [versionId],
      blobs: [versionTag],
      //...
    });
    //...
  },
} satisfies ExportedHandler<Env>;