mapingv1

type Envelope struct {
	Service    string `protobuf:"bytes,1,opt,name=service,proto3" json:"service,omitempty"`                         // logical app name (auto-derived)
	Instance   string `protobuf:"bytes,2,opt,name=instance,proto3" json:"instance,omitempty"`                       // replica id (auto-derived)
	SdkVersion string `protobuf:"bytes,3,opt,name=sdk_version,json=sdkVersion,proto3" json:"sdk_version,omitempty"` // client SDK version, for compat handling
	// sketch_format_version identifies the DDSketch bucket layout so the server
	// can reject sketches it cannot interpret rather than corrupt percentiles.
	SketchFormatVersion uint32 `protobuf:"varint,4,opt,name=sketch_format_version,json=sketchFormatVersion,proto3" json:"sketch_format_version,omitempty"`
	// dropped_summaries counts Summaries dropped by client backpressure since the
	// last successful upload, so the gap is visible rather than silent.
	DroppedSummaries uint64 `protobuf:"varint,5,opt,name=dropped_summaries,json=droppedSummaries,proto3" json:"dropped_summaries,omitempty"`
	// deploy_version is the release version (semver or image tag) the process is
	// running. A stored, low-cardinality dimension used to answer "did release X
	// regress this endpoint?" — NOT part of the client-side series key.
	DeployVersion string `protobuf:"bytes,6,opt,name=deploy_version,json=deployVersion,proto3" json:"deploy_version,omitempty"`
	// deploy_id is the immutable build identity (git SHA / CI build id), so two
	// releases sharing a version string can still be told apart.
	DeployId string `protobuf:"bytes,7,opt,name=deploy_id,json=deployId,proto3" json:"deploy_id,omitempty"`
	// environment is the deployment environment (prod/staging/dev), a stored
	// low-cardinality dimension.
	Environment string `protobuf:"bytes,8,opt,name=environment,proto3" json:"environment,omitempty"`
	// region is the deployment region (e.g. eu-west-1), a stored low-cardinality
	// dimension.
	Region string `protobuf:"bytes,9,opt,name=region,proto3" json:"region,omitempty"`
	// instance_start_time_ms is the process boot wall-clock in epoch millis, so
	// restarts can be correlated with a change in behavior.
	InstanceStartTimeMs int64 `protobuf:"varint,10,opt,name=instance_start_time_ms,json=instanceStartTimeMs,proto3" json:"instance_start_time_ms,omitempty"`
	// contains filtered or unexported fields
}

type Exemplar struct {
	AtMs       int64  `protobuf:"varint,1,opt,name=at_ms,json=atMs,proto3" json:"at_ms,omitempty"`                   // request completion wall-clock, epoch millis
	DurationNs uint64 `protobuf:"varint,2,opt,name=duration_ns,json=durationNs,proto3" json:"duration_ns,omitempty"` // request latency
	StatusCode uint32 `protobuf:"varint,3,opt,name=status_code,json=statusCode,proto3" json:"status_code,omitempty"` // exact HTTP status (0 when none was written)
	TraceId    string `protobuf:"bytes,4,opt,name=trace_id,json=traceId,proto3" json:"trace_id,omitempty"`           // W3C/OTel trace id (32 hex chars), optional
	SpanId     string `protobuf:"bytes,5,opt,name=span_id,json=spanId,proto3" json:"span_id,omitempty"`              // W3C/OTel span id (16 hex chars), optional
	RequestId  string `protobuf:"bytes,6,opt,name=request_id,json=requestId,proto3" json:"request_id,omitempty"`     // app request id (e.g. X-Request-Id), optional
	// contains filtered or unexported fields
}

type Handshake struct {
	Service             string `protobuf:"bytes,1,opt,name=service,proto3" json:"service,omitempty"`
	Instance            string `protobuf:"bytes,2,opt,name=instance,proto3" json:"instance,omitempty"`
	SdkVersion          string `protobuf:"bytes,3,opt,name=sdk_version,json=sdkVersion,proto3" json:"sdk_version,omitempty"`
	SketchFormatVersion uint32 `protobuf:"varint,4,opt,name=sketch_format_version,json=sketchFormatVersion,proto3" json:"sketch_format_version,omitempty"`
	// contains filtered or unexported fields
}

type InstanceWindow struct {
	WindowStartMs  int64  `protobuf:"varint,1,opt,name=window_start_ms,json=windowStartMs,proto3" json:"window_start_ms,omitempty"`    // window start, epoch millis (client wall clock)
	WindowEndMs    int64  `protobuf:"varint,2,opt,name=window_end_ms,json=windowEndMs,proto3" json:"window_end_ms,omitempty"`          // window end, epoch millis
	CpuNs          uint64 `protobuf:"varint,3,opt,name=cpu_ns,json=cpuNs,proto3" json:"cpu_ns,omitempty"`                              // process CPU time consumed during the window
	RssBytes       uint64 `protobuf:"varint,4,opt,name=rss_bytes,json=rssBytes,proto3" json:"rss_bytes,omitempty"`                     // resident memory proxy (runtime Sys bytes)
	HeapAllocBytes uint64 `protobuf:"varint,5,opt,name=heap_alloc_bytes,json=heapAllocBytes,proto3" json:"heap_alloc_bytes,omitempty"` // live heap bytes at sample time
	GcPauseNs      uint64 `protobuf:"varint,6,opt,name=gc_pause_ns,json=gcPauseNs,proto3" json:"gc_pause_ns,omitempty"`                // GC stop-the-world pause time during the window
	Goroutines     uint64 `protobuf:"varint,7,opt,name=goroutines,proto3" json:"goroutines,omitempty"`                                 // goroutine count at sample time
	// num_gc is the number of completed GC cycles during the window (a DELTA of the
	// cumulative runtime counter), so GC frequency can be read as num_gc/window.
	NumGc uint64 `protobuf:"varint,8,opt,name=num_gc,json=numGc,proto3" json:"num_gc,omitempty"`
	// total_alloc_bytes is the bytes allocated on the heap during the window (a
	// DELTA of the cumulative counter), giving the allocation rate.
	TotalAllocBytes uint64 `protobuf:"varint,9,opt,name=total_alloc_bytes,json=totalAllocBytes,proto3" json:"total_alloc_bytes,omitempty"`
	// mallocs is the number of heap objects allocated during the window (a DELTA of
	// the cumulative counter); total_alloc_bytes/mallocs is the average alloc size.
	Mallocs uint64 `protobuf:"varint,10,opt,name=mallocs,proto3" json:"mallocs,omitempty"`
	// gc_cpu_fraction is the fraction of total CPU time spent in GC since process
	// start (0..1), a point-in-time gauge covering concurrent GC, not just STW.
	GcCpuFraction float64 `protobuf:"fixed64,11,opt,name=gc_cpu_fraction,json=gcCpuFraction,proto3" json:"gc_cpu_fraction,omitempty"`
	// heap_inuse_bytes is in-use heap bytes at sample time (spans with live objects),
	// a tighter memory read than rss_bytes. Point-in-time gauge.
	HeapInuseBytes uint64 `protobuf:"varint,12,opt,name=heap_inuse_bytes,json=heapInuseBytes,proto3" json:"heap_inuse_bytes,omitempty"`
	// gomaxprocs is the process's GOMAXPROCS at sample time, used to normalize CPU
	// intensity to a share of available cores. Point-in-time gauge.
	Gomaxprocs uint32 `protobuf:"varint,13,opt,name=gomaxprocs,proto3" json:"gomaxprocs,omitempty"`
	// post_gc_heap_bytes is the live heap as of the last completed GC mark
	// (/gc/heap/live:bytes), the post-GC baseline. Unlike heap_alloc_bytes (an
	// arbitrary sample point), a monotonically rising value distinguishes a leak
	// from an allocation burst. Point-in-time gauge.
	PostGcHeapBytes uint64 `protobuf:"varint,14,opt,name=post_gc_heap_bytes,json=postGcHeapBytes,proto3" json:"post_gc_heap_bytes,omitempty"`
	// rss_true_bytes is true resident set size from the OS (Linux /proc/self/statm),
	// unlike rss_bytes which is runtime Sys (reserved address space). Best-effort:
	// 0 on platforms where it is not wired up. Point-in-time gauge.
	RssTrueBytes uint64 `protobuf:"varint,15,opt,name=rss_true_bytes,json=rssTrueBytes,proto3" json:"rss_true_bytes,omitempty"`
	// open_fds is the count of open file descriptors (Linux /proc/self/fd entries).
	// A rising count proxies leaking or accumulating connections/files. Best-effort:
	// 0 on platforms where it is not wired up. Point-in-time gauge.
	OpenFds uint64 `protobuf:"varint,16,opt,name=open_fds,json=openFds,proto3" json:"open_fds,omitempty"`
	// fd_limit is the soft RLIMIT_NOFILE ceiling, so nearness to the limit ("open_fds
	// over fd_limit") is computable. Best-effort: 0 on platforms where it is not
	// wired up. Point-in-time gauge.
	FdLimit uint64 `protobuf:"varint,17,opt,name=fd_limit,json=fdLimit,proto3" json:"fd_limit,omitempty"`
	// in_flight is the PEAK number of requests in flight during the window, tracked
	// by the recorder as adapters enter/leave each handler. It shows the process
	// backing up (blocked, not busy) when latency rises but CPU/GC stay flat.
	InFlight uint64 `protobuf:"varint,18,opt,name=in_flight,json=inFlight,proto3" json:"in_flight,omitempty"`
	// contains filtered or unexported fields
}

type NoStatusReason int32

type RegisterResponse struct {
	Accepted bool   `protobuf:"varint,1,opt,name=accepted,proto3" json:"accepted,omitempty"`
	Reason   string `protobuf:"bytes,2,opt,name=reason,proto3" json:"reason,omitempty"`
	// contains filtered or unexported fields
}

type StatusClass int32

type Summary struct {
	WindowStartMs int64       `protobuf:"varint,1,opt,name=window_start_ms,json=windowStartMs,proto3" json:"window_start_ms,omitempty"` // client wall clock, window start
	WindowEndMs   int64       `protobuf:"varint,2,opt,name=window_end_ms,json=windowEndMs,proto3" json:"window_end_ms,omitempty"`       // client wall clock, window end
	Method        string      `protobuf:"bytes,3,opt,name=method,proto3" json:"method,omitempty"`                                       // HTTP method
	RouteTemplate string      `protobuf:"bytes,4,opt,name=route_template,json=routeTemplate,proto3" json:"route_template,omitempty"`    // registered route template, never raw path
	StatusClass   StatusClass `protobuf:"varint,5,opt,name=status_class,json=statusClass,proto3,enum=maping.v1.StatusClass" json:"status_class,omitempty"`
	Count         uint64      `protobuf:"varint,6,opt,name=count,proto3" json:"count,omitempty"`                                        // requests in window (gives rate)
	SumDurationNs uint64      `protobuf:"varint,7,opt,name=sum_duration_ns,json=sumDurationNs,proto3" json:"sum_duration_ns,omitempty"` // for an exact mean alongside sketch percentiles
	ReqBytes      uint64      `protobuf:"varint,8,opt,name=req_bytes,json=reqBytes,proto3" json:"req_bytes,omitempty"`                  // summed request bytes (bandwidth per endpoint)
	RespBytes     uint64      `protobuf:"varint,9,opt,name=resp_bytes,json=respBytes,proto3" json:"resp_bytes,omitempty"`               // summed response bytes
	// latency_sketch is a DDSketch as a sparse bucket-index -> count map.
	// Keys are int32 to match server storage (Map(Int32,UInt64)) and avoid a
	// future migration. Interpreted per Envelope.sketch_format_version.
	LatencySketch map[int32]uint64 `` /* 177-byte string literal not displayed */
	// status_code_breakdown is the exact-code detail (bounded, top-N) for the
	// endpoint-detail view. Not a series-key dimension.
	StatusCodeBreakdown map[uint32]uint64 `` /* 197-byte string literal not displayed */
	// max_duration_ns is the exact slowest request observed in the window. Unlike
	// the DDSketch percentiles (which are relative-error bounded), this is the
	// true tail latency, merged across summaries with max.
	MaxDurationNs uint64 `protobuf:"varint,12,opt,name=max_duration_ns,json=maxDurationNs,proto3" json:"max_duration_ns,omitempty"`
	// exemplars is a BOUNDED, best-effort sample of real requests from the window
	// (the single slowest plus a few errors), so a user can pivot from a p99 or
	// error spike to an actual request to open in their tracing tool or logs.
	// They are breadcrumbs, not exact data: the client caps them per window and
	// the server keeps them ONLY in the raw (finest) tier under its short TTL —
	// rollups drop them. Not a series-key dimension.
	Exemplars []*Exemplar `protobuf:"bytes,13,rep,name=exemplars,proto3" json:"exemplars,omitempty"`
	// error_class_breakdown is a bounded, top-N count of normalized error labels
	// (uppercase [A-Z0-9_], <=64 chars) the app/framework attached to requests in
	// the window, so a 5xx spike can be attributed to a cause ("DB_POOL_EXHAUSTED"
	// vs "UPSTREAM_TIMEOUT"). Bounded per series like status_code_breakdown; not a
	// series-key dimension.
	ErrorClassBreakdown map[string]uint64 `` /* 196-byte string literal not displayed */
	// no_status_reasons counts, by NoStatusReason, why requests ended without a
	// status written (see StatusClass NO_STATUS): timing out vs canceling vs
	// crashing. The key is the NoStatusReason enum value carried as uint32, since
	// proto3 map keys cannot be enum-typed.
	NoStatusReasons map[uint32]uint64 `` /* 185-byte string literal not displayed */
	// sum_downstream_duration_ns is the summed time requests in the window spent
	// waiting on downstream calls (outbound HTTP, and later DB/cache), so the
	// endpoint's own time can be split from time it was merely blocked on a
	// dependency — "the extra 45ms is all downstream". It is a scalar sum captured
	// by the maping RoundTripper; requests that make no downstream calls (or a
	// service that does not wire the RoundTripper) contribute zero, so the panel
	// feature-gates on data presence.
	SumDownstreamDurationNs uint64 `` /* 136-byte string literal not displayed */
	// contains filtered or unexported fields
}

type UploadRequest struct {
	Envelope  *Envelope  `protobuf:"bytes,1,opt,name=envelope,proto3" json:"envelope,omitempty"`
	Summaries []*Summary `protobuf:"bytes,2,rep,name=summaries,proto3" json:"summaries,omitempty"`
	// instance_windows carries per-process resource gauges (USE: CPU, memory,
	// goroutines, GC pause) sampled once per flush window, so a latency rise can be
	// correlated with saturation ("p99 rose because GC pauses tripled") without a
	// release. It is a separate stream from the per-endpoint summaries and is stored
	// in its own table; typically one entry per upload.
	InstanceWindows []*InstanceWindow `protobuf:"bytes,3,rep,name=instance_windows,json=instanceWindows,proto3" json:"instance_windows,omitempty"`
	// contains filtered or unexported fields
}

type UploadResponse struct {

	// accepted is false when the whole batch was rejected (e.g. bad key handled
	// at the transport layer); reason carries a machine-readable code the client
	// logs (rate-limited) and surfaces in the dashboard.
	Accepted bool   `protobuf:"varint,1,opt,name=accepted,proto3" json:"accepted,omitempty"`
	Reason   string `protobuf:"bytes,2,opt,name=reason,proto3" json:"reason,omitempty"`
	// rejected_summaries reports partial drops (e.g. cardinality frozen) so the
	// client can log the count without failing the whole upload.
	RejectedSummaries uint64 `protobuf:"varint,3,opt,name=rejected_summaries,json=rejectedSummaries,proto3" json:"rejected_summaries,omitempty"`
	// contains filtered or unexported fields
}