Skip to the content.

Native performance artifact index

The native artifact index is the bounded drill-down surface from a Grafana point to the exact scrubbed evidence behind it. It accepts only the opaque npc1_<32 lowercase hex> correlation key defined by native-performance-correlation.md; it never joins on request IDs, run IDs, paths, or Grafana labels.

Contract

The package contract is internal/nativeperfartifact (fak-native-performance-artifacts/1). A production adapter may persist or serve its scrubbed snapshot, but must preserve these rejection and capacity rules.

Grafana status

fak-native-artifacts does not pretend that the in-memory index is already exported through Prometheus. The live dashboard shows only the bounded native receipt streams and freshness families that the gateway actually emits. It carries no correlation-key variable, artifact annotation, or clickable resolver URL, because the binary does not yet expose an artifact_info metric or a public resolver adapter.

The checked-in provisioning fixture still uses documentation-only .invalid URLs and synthetic keys to prove the future query, label, link, and failure-state shape. It is not live telemetry or benchmark evidence. When a production adapter lands, it must wire the scrubbed index into the binary, preserve the exact-key rejection rules above, and only then enable per-artifact Grafana links.