バージョンメタデータ

バージョンメタデータバインディングを使うと、Workers ランタイム内から、バージョンに紐づくメタデータへアクセスできます。

Worker のバージョン ID、バージョンタグ、バージョン作成日時は、バージョンメタデータバインディング経由で取得できます。これらは Workers Analytics Engine や、サードパーティの分析・メトリクスサービスへ送るイベントで使い、Worker バージョンごとに集計できます。

バージョンメタデータバインディングを使うには、Worker の Wrangler ファイルを更新します。

{
	"version_metadata": {
		"binding": "CF_VERSION_METADATA"
	}
}

[version_metadata]
binding = "CF_VERSION_METADATA"

インターフェイス

Worker 内からバージョン ID とバージョンタグにアクセスし、Workers Analytics Engine へイベントを送る例です。

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],
      //...
    });
    //...
  },
};

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>;