metering

type DonIdentity struct {

	// The authoritative DON ID of the emitting service. For capability LOOPs this
	// is CapDONID supplied over the standardcapabilities interface; for
	// workflow-DON services (e.g. the syncer) it is the workflow DON ID.
	DonId string `protobuf:"bytes,1,opt,name=don_id,json=donId,proto3" json:"don_id,omitempty"`
	// The node's logical name (e.g. "clp-cre-wf-zone-a-1"), not the CSA public
	// key. Events will include csa key, handled by ChIP rotating signer. In the long
	// term, the ResourceIdentity + DonIdentity should be unambiguous to aggregate.
	NodeId string `protobuf:"bytes,2,opt,name=node_id,json=nodeId,proto3" json:"node_id,omitempty"`
	// contains filtered or unexported fields
}

type MeterAction int32

type MeterRecord struct {

	// Time at which the metered request/occurrence happened (a raw edge, not
	// truncated to a bucket boundary).
	Timestamp *timestamppb.Timestamp `protobuf:"bytes,1,opt,name=timestamp,proto3" json:"timestamp,omitempty"`
	// Structured identity of the affected resource (deployment/DON/node
	// dimensions + service + resource/resource_type + the physical resource_id).
	Identity *ResourceIdentity `protobuf:"bytes,2,opt,name=identity,proto3" json:"identity,omitempty"`
	// Billing semantics of this record: METER_ACTION_UPDATE (signed level delta)
	// or METER_ACTION_USAGE (one-off consumption).
	Action MeterAction `protobuf:"varint,3,opt,name=action,proto3,enum=metering.v1.MeterAction" json:"action,omitempty"`
	// One or more utilization quantities for this event (e.g. multiple billing
	// units affected by the same request).
	Utilizations []*Utilization `protobuf:"bytes,4,rep,name=utilizations,proto3" json:"utilizations,omitempty"`
	// contains filtered or unexported fields
}

type MeterSnapshot struct {

	// Time at which the snapshot was taken (the interval boundary it covers).
	Timestamp *timestamppb.Timestamp `protobuf:"bytes,1,opt,name=timestamp,proto3" json:"timestamp,omitempty"`
	// Full identity of the one resource this snapshot covers: the six coarse
	// dimensions (product, environment, zone, don_id, node_id, service) plus
	// resource, resource_type, and resource_id.
	Identity *ResourceIdentity `protobuf:"bytes,2,opt,name=identity,proto3" json:"identity,omitempty"`
	// Utilization of this one resource. value is the current level; the
	// per-interval increment is value over the interval below.
	Utilization []*Utilization `protobuf:"bytes,3,rep,name=utilization,proto3" json:"utilization,omitempty"`
	// Nominal period this snapshot covers, for staleness detection and for
	// computing the per-interval increment by the consumer.
	Interval *durationpb.Duration `protobuf:"bytes,4,opt,name=interval,proto3" json:"interval,omitempty"`
	// contains filtered or unexported fields
}

type ResourceIdentity struct {

	// Deployment product, e.g. "cre". One of the deployment+DON+node
	// dimensions used for coarse billing rollup.
	Product string `protobuf:"bytes,1,opt,name=product,proto3" json:"product,omitempty"`
	// Deployment tenant name, e.g. "mainline" or "enterprise". This is the
	// human-readable tenant label (not the numeric tenant ID).
	Tenant string `protobuf:"bytes,2,opt,name=tenant,proto3" json:"tenant,omitempty"`
	// Numeric tenant identifier as used by Accounts/Linking/registry/Vault DON.
	// This is a numbered identifier represented as a string.
	NumericTenantId string `protobuf:"bytes,3,opt,name=numeric_tenant_id,json=numericTenantId,proto3" json:"numeric_tenant_id,omitempty"`
	// Deployment environment, e.g. "production", "staging". A coarse
	// billing-rollup dimension.
	Environment string `protobuf:"bytes,4,opt,name=environment,proto3" json:"environment,omitempty"`
	// Deployment zone, e.g. "wf-zone-a". A coarse billing-rollup dimension.
	Zone string `protobuf:"bytes,5,opt,name=zone,proto3" json:"zone,omitempty"`
	// DON-specific identity dimensions. Present only for DON emitters. Web2 or
	// other non-DON emitters leave this unset instead of sending empty IDs.
	Don *DonIdentity `protobuf:"bytes,6,opt,name=don,proto3,oneof" json:"don,omitempty"`
	// Stable service constant identifying the emitting service (the old
	// `entity`), e.g. "cron-trigger", "http-trigger", "evm-log-trigger",
	// "workflow-syncer-v2". A coarse billing-rollup dimension.
	Service string `protobuf:"bytes,7,opt,name=service,proto3" json:"service,omitempty"`
	// Resource pool the action applies to, e.g. "trigger_registrations",
	// "log_filters", "workflow_storage". Human friendly name
	ResourcePool string `protobuf:"bytes,8,opt,name=resource_pool,json=resourcePool,proto3" json:"resource_pool,omitempty"`
	// optionality to add a level of hierarchy within the resource_pool, or
	// UID a resource_pool
	ResourcePoolId string `protobuf:"bytes,9,opt,name=resource_pool_id,json=resourcePoolId,proto3" json:"resource_pool_id,omitempty"`
	// contains filtered or unexported fields
}

type Utilization struct {

	// Signed base-10 integer string ("-3" is valid). For METER_ACTION_UPDATE it is
	// the level delta; for METER_ACTION_USAGE it is the consumed quantity; for
	// MeterSnapshot it is the current absolute level (always >= 0).
	Value string `protobuf:"bytes,1,opt,name=value,proto3" json:"value,omitempty"`
	// The type of utilization that value measures.
	// e.g. RESOURCE_TYPE_COMPUTE
	ResourceType string `protobuf:"bytes,2,opt,name=resource_type,json=resourceType,proto3" json:"resource_type,omitempty"`
	// primarily valuable for workflow receipts where you could have workflowID.
	// persistant storage with a pre-allocated slice has a resource_id
	// to identify it.
	ResourceId string `protobuf:"bytes,3,opt,name=resource_id,json=resourceId,proto3" json:"resource_id,omitempty"`
	// Unique for MeterRecords, generated by the emitting resource manager;
	// the consumer-side dedup key for at-least-once delivery.
	EventId string `protobuf:"bytes,4,opt,name=event_id,json=eventId,proto3" json:"event_id,omitempty"`
	// Resolved at emission time from the stored workflow owner; may lag an owner
	// org link/unlink by at most the resolver cache TTL.
	OrgId string `protobuf:"bytes,5,opt,name=org_id,json=orgId,proto3" json:"org_id,omitempty"`
	// contains filtered or unexported fields
}