Skip to main content

Metric declarations

These declarations are extracted from registered metric option blocks. Full names combine the registry namespace (seagull), subsystem, and name; histogram exposition also includes bucket/sum/count series. Check the live /metrics response for the signals registered by a specific executable. See observability.

internal/advisoryfeed

Definitions

NameMeaning
seagull_advisoryfeed_syncs_totalAttempts to follow a feed, by whether they read everything it listed.
seagull_advisoryfeed_advisories_totalRecords a feed listed as changed, by what the importer made of them.
seagull_advisoryfeed_checked_timestamp_secondsWhen the importer last asked a feed what it lists.
seagull_advisoryfeed_synced_timestamp_secondsWhen the platform last held everything a feed listed: how old its copy of the feed is.
seagull_advisoryfeed_newest_listed_timestamp_secondsThe newest change a feed itself lists: how current the feed is.
seagull_advisoryfeed_held_advisoriesAdvisories the platform holds from a feed.
seagull_advisoryfeed_sync_duration_secondsTime one attempt to follow a feed took.

internal/advisorystore

Definitions

NameMeaning
seagull_advisorystore_records_totalAdvisory records by what the writer did with them.
seagull_advisorystore_rows_totalRows written, by the table they were written to.
seagull_advisorystore_batches_totalBatches of records by whether they became durable or had to be retried.
seagull_advisorystore_refusals_totalRecords that were not advisories this build could store, by why.
seagull_advisorystore_batch_recordsRecords carried by a batch handed to the advisory writer.
seagull_advisorystore_write_duration_secondsTime spent making a batch of advisories durable in the store.

internal/alertstore

Definitions

NameMeaning
seagull_alertstore_alerts_totalDetections by what became of them: raised, folded, repeated or cooled down.
seagull_alertstore_incidents_totalCorrelations by what became of them: opened, or recognised as one already open.
seagull_alertstore_batches_totalBatches of detections by whether they became durable or had to be retried.
seagull_alertstore_skipped_totalRecords that did not become an alert, by why.
seagull_alertstore_suppressed_totalDetections the estate declared it does not want as work, by rule and by the reason written down.
seagull_alertstore_batch_detectionsRecords carried by a batch handed to the alert writer.
seagull_alertstore_write_duration_secondsTime spent making a batch of alerts durable in the store.

internal/analysis

Definitions

NameMeaning
seagull_analysis_events_totalRecords by what the engine could do with them.
seagull_analysis_refusals_totalRecords the engine could not turn into an event, by why.
seagull_analysis_routed_totalEvents by the route their class sends them down.
seagull_analysis_unrouted_totalEvents this build has no route for, by the class they carry.
seagull_analysis_normalized_totalEvents the engine had to rewrite into canonical form, by route.
seagull_analysis_batch_eventsRecords carried by a batch handed to the engine.
seagull_analysis_event_delay_secondsDistance between the platform accepting an event and the engine analysing it.
seagull_detection_evaluations_totalRules decided against an event, by the route they are registered on.
seagull_detection_matches_totalRules that matched an event, by route and by how much the rule says it matters.
seagull_detection_secondsTime spent deciding one event against every rule on its route.
seagull_detection_published_totalDetections the backbone made durable.
seagull_detection_batches_totalBatches of detections by whether the backbone took them; a retry is counted apart from the batch it belongs to.
seagull_detection_state_observations_totalEvents a counting rule matched, by what its window did with them.
seagull_detection_state_saturated_totalObservations folded into a key that was already full, whose count is therefore a floor.
seagull_detection_sequences_unordered_totalSequences whose events were timed by clocks disagreeing by more than the sequence itself lasted, so the order is reported and not vouched for.

internal/broker

Definitions

NameMeaning
seagull_backbone_records_fetched_totalRecords fetched from the backbone.
seagull_backbone_fetch_errors_totalFailed fetches, by topic and partition.
seagull_backbone_commit_errors_totalRefused attempts to advance the group position.
seagull_backbone_consumer_lag_refresh_errors_totalFailed attempts to refresh partition end offsets.
seagull_backbone_consumer_lag_recordsRecords between the committed processing position and the end of the partition.
seagull_backbone_state_rebuild_partitions_totalPartitions read back from an earlier position so what a rule remembers could be rebuilt.
seagull_backbone_state_rebuild_records_totalRecords a rebuild put back in front of the reader.
seagull_backbone_partitions_moved_totalPartitions this reader took from its group or gave back to it.
seagull_backbone_partitions_heldPartitions of the topic this reader is currently assigned.

internal/control

Definitions

NameMeaning
seagull_control_policy_infoIdentity of the policy the process is pinned to.
seagull_control_policy_rolesRoles the current policy declares.
seagull_control_policy_bindingsSubjects the current policy binds.
seagull_control_policy_pinned_timestamp_secondsWhen the process last changed the policy it is pinned to.
seagull_control_policy_reloads_totalAttempts to read the policy source again, by what came of them.
seagull_control_authentications_totalAttempts to establish who a caller is, by what came of them.
seagull_control_authorizations_totalDecisions about what a caller may do, by why they were decided that way.
seagull_control_sessions_liveSessions this process has minted and still honours.
seagull_control_sessions_opened_totalSessions minted.
seagull_control_sessions_ended_totalSessions that stopped being spendable, by what ended them.
seagull_control_rate_limited_totalRequests refused for spending more than a caller's share.
seagull_control_rulesets_published_totalAttempts to publish a ruleset, by what came of them.
seagull_control_rulesets_activated_totalAttempts to activate a published ruleset, by what came of them.
seagull_control_alerts_moved_totalAttempts to move an alert, by the state it reached or by refusal.
seagull_control_incidents_moved_totalAttempts to move an incident, by the state it reached or by refusal.
seagull_control_agents_moved_totalAttempts to register or move an agent, by the state it reached or by refusal.
seagull_control_agent_admissions_totalAttempts to tell the data plane what was decided about an agent, by what came of them.
seagull_control_agent_certificates_issued_totalCertificates an operator asked the platform to sign, by the state the agent reached or by refusal.
seagull_control_agent_certificates_renewed_totalCertificates an agent asked to replace with the one it held, by what came of them.
seagull_control_agent_admissions_outstandingAgents whose recorded state the data plane has not been told about.

internal/detectionstore

Definitions

NameMeaning
seagull_detectionstore_detections_totalRecords by what the detection writer did with them.
seagull_detectionstore_batches_totalBatches of detections by whether they became durable or had to be retried.
seagull_detectionstore_refusals_totalRecords that were not detections this build could store, by why.
seagull_detectionstore_batch_detectionsRecords carried by a batch handed to the detection writer.
seagull_detectionstore_write_duration_secondsTime spent making a batch of detections durable in the store.

internal/eventstore

Definitions

NameMeaning
seagull_eventstore_events_totalRecords by what the writer did with them.
seagull_eventstore_batches_totalBatches by whether they became durable or had to be retried.
seagull_eventstore_refusals_totalQuarantined records by why they were refused.
seagull_eventstore_batch_eventsRecords carried by a batch handed to the writer.
seagull_eventstore_write_duration_secondsTime spent making a batch durable in the store.

internal/hunt

Definitions

NameMeaning
seagull_hunt_queries_totalQuestions asked of the store, by dataset and how they ended.
seagull_hunt_refusals_totalQuestions the query plane would not put to the store, by why.
seagull_hunt_page_recordsRecords carried by one page of an answer.
seagull_hunt_answer_duration_secondsTime the store spent answering one question.

internal/ingest

Definitions

NameMeaning
seagull_ingest_batches_totalEvent batches by admission outcome.
seagull_ingest_events_totalEvents by admission outcome.
seagull_ingest_rejections_totalRejected batches by reason.
seagull_ingest_batch_eventsEvents carried by an admitted batch.
seagull_ingest_publish_duration_secondsTime spent making a batch durable in the backbone.
seagull_ingest_event_lag_secondsDistance between the time an event happened and the time the platform accepted it.
seagull_ingest_inflight_bytesRequest bytes the gateway has reserved and not yet released.
seagull_ingest_inflight_requestsRequests the gateway is holding at once.
seagull_ingest_inflight_byte_ceilingRequest bytes the gateway holds at once before it refuses work.
seagull_ingest_inflight_request_ceilingRequests the gateway holds at once before it refuses work.

internal/inventorystore

Definitions

NameMeaning
seagull_inventorystore_records_totalRecords by what the inventory projector did with them.
seagull_inventorystore_items_totalItems folded into the current state of an asset, by the kind of thing they are.
seagull_inventorystore_scans_totalFull enumerations that moved the line absence is measured against.
seagull_inventorystore_batches_totalBatches of records by whether they became durable or had to be retried.
seagull_inventorystore_refusals_totalRecords that were not inventory this build could store, by why.
seagull_inventorystore_batch_recordsRecords carried by a batch handed to the inventory projector.
seagull_inventorystore_write_duration_secondsTime spent making a batch of inventory durable in the store.

internal/ruleset

Definitions

NameMeaning
seagull_ruleset_infoIdentity of the ruleset the process is pinned to.
seagull_ruleset_rulesRules the current ruleset holds, by whether they are evaluated.
seagull_ruleset_loaded_timestamp_secondsWhen the process last changed the ruleset it is pinned to.
seagull_ruleset_reloads_totalAttempts to read the source again, by what came of them.
seagull_ruleset_activations_totalRulesets this process was asked to run, by whether it could.