OCI Observability Professional key terms
OCI Observability Professional · Get comfortable with the vocabulary.
- Metric Namespace
- Related: Metric, Alarm Query
A string label that groups related metrics, such as oci_computeagent or oci_lb, so that queries and policies can target one service's measurements without naming every metric individually.
- Metric
- Related: Dimension, Metric Namespace, MQL
A time-stamped numeric measurement emitted for a resource, identified by namespace, metric name, and a set of dimension key-value pairs. Metrics are aggregated over intervals and retained per the service's retention rules.
- Dimension
- Related: Metric, MQL
A key-value attribute attached to a metric that identifies the source, such as resourceId, availabilityDomain, or faultDomain. Dimensions let a single metric name carry many independent time series.
- MQL
- Related: Alarm Query, Aggregation Interval, Metric
Monitoring Query Language: the expression syntax used to select metrics, apply functions such as rate, mean, or percentile, and combine series. It appears in alarm queries, charts, and the Monitoring API.
- Alarm Query
- Related: MQL, Alarm
The MQL expression inside an alarm that defines which metric streams are evaluated and how they are reduced, for example averaging CPU utilization across instances in a compartment.
- Aggregation Interval
- Related: MQL, Alarm Evaluation
The time window over which raw metric data points are combined before evaluation, commonly one or five minutes. Shorter intervals react faster but are noisier and can trigger more false positives.
- Alarm
- Related: Alarm Query, Trigger Rule, Notification Topic
A Monitoring resource that evaluates a metric query against a threshold over a rolling window and transitions between OK, FIRING, and sometimes RESET states, notifying configured destinations on state change.
- Trigger Rule
- Related: Alarm, Alarm Evaluation, Pending Duration
The threshold logic in an alarm, including operator, value, breach duration, and the number of consecutive evaluation windows that must be breached before the alarm fires.
- Alarm Evaluation
- Related: Trigger Rule, Aggregation Interval, Alarm
The recurring process in which the Monitoring service runs an alarm's query, compares results to the trigger rule, and updates alarm state. Evaluation frequency is tied to the alarm's interval setting.
- Pending Duration
- Related: Trigger Rule, Alarm
The length of time a threshold must remain breached before an alarm moves to FIRING, filtering out brief spikes. It is expressed in minutes and combined with the evaluation interval.
- Alarm Severity
- Related: Alarm, Notification Topic
A label such as CRITICAL, WARNING, or INFO attached to an alarm so notifications and dashboards can be prioritized and routed differently by urgency.
- Composite Alarm
- Related: Alarm, Alarm Suppression
An alarm whose state is derived from the states of other alarms using Boolean operators, reducing noise by firing only when several conditions coincide or when a group of alarms is unhealthy.
- Alarm Suppression
- Related: Composite Alarm, Notification Topic
A scheduled window during which an alarm does not notify, used for planned maintenance so expected outages do not page responders. Suppressed alarms still evaluate but notifications are withheld.
- Agent Configuration
- Related: Management Agent, Custom Metric
The policy that tells the Management Agent which metrics to collect and which logs to ingest from a compute instance, including custom metric definitions and log source paths.
- Custom Metric
- Related: Agent Configuration, Metric Namespace
A user-defined metric pushed to the Monitoring service through the API, CLI, or agent, useful for application-specific signals such as queue depth or business transaction counts.
- Health Check
- Related: Metric, Availability Monitoring
A Monitoring feature that probes a URL or port from multiple global vantage points and reports availability, latency, and status codes as metrics without requiring an agent.
- Availability Monitoring
- Related: Health Check, Synthetic Monitoring
The practice of continuously testing whether an endpoint responds correctly from outside the tenancy, complementing internal resource metrics. Results feed dashboards and alarms for reachability.
- Synthetic Monitoring
- Related: Availability Monitoring, Health Check
Scripted or scripted-browser transactions executed on a schedule to verify user journeys end to end, producing pass/fail and timing data that internal metrics cannot reveal.
- Log Group
- Related: Log, Log Retention, Service Connector
A logical container in Logging that holds related logs and carries its own retention and access settings. Every log must belong to exactly one log group.
- Log
- Related: Log Group, Unified Monitoring Agent, Log Entry
A named collection of log entries within a log group, usually corresponding to one source such as an instance's system log or an audit stream. Logs are the unit agents and connectors write to.
- Log Entry
- Related: Log, Saved Search
A single record inside a log consisting of a timestamp, message data, and optional metadata. Entries are what search queries, saved searches, and connectors process.
- Unified Monitoring Agent
- Related: Log, Agent Configuration, Service Connector
The agent installed on compute instances that collects both metrics and logs and forwards them to Monitoring and Logging, replacing separate collection agents.
- Service Log
- Related: Log, Audit Log
A log emitted automatically by an Oracle Cloud Infrastructure service, such as VCN flow logs or Object Storage access logs, which must be enabled on the source resource before entries appear.
- Audit Log
- Related: Service Log, Log Entry
The immutable record of API activity in a tenancy, capturing who did what, when, and from where. It is retained for a fixed period and is central to security investigations.
- Saved Search
- Related: Log Entry, Service Connector
A stored Logging query, including filters and time range, that can be rerun or referenced by dashboards and connectors to select which entries flow onward.
- Log Retention
- Related: Log Group, Log
The configured period for which log entries remain queryable before automatic deletion. Longer retention costs more and must be planned against compliance requirements.
- Service Connector
- Related: Connector Source, Connector Task, Connector Target
A resource that reads data from a source such as Logging or Streaming, optionally runs a task like filtering or anonymizing, and delivers results to a target such as Object Storage or Notifications.
- Connector Source
- Related: Service Connector, Connector Target
The origin of data for a service connector, for example a log group, a stream, or Monitoring metrics. The source defines the shape of records the connector moves.
- Connector Task
- Related: Service Connector, Connector Target
An optional transformation applied in flight by a service connector, such as filtering records by a condition, masking fields, or converting format before delivery.
- Connector Target
- Related: Service Connector, Connector Source, Notification Topic
The destination a service connector writes to, such as an Object Storage bucket, a Streaming stream, a Functions function, or a Notifications topic. One connector has one target.
- Notification Topic
- Related: Subscription, Alarm, Service Connector
A publish-subscribe channel in the Notifications service to which messages are published and from which subscriptions deliver them by email, HTTPS, SMS, or function invocation.
- Subscription
- Related: Notification Topic, Webhook
An endpoint registered against a notification topic, such as an email address or webhook URL. Each subscription must confirm before it receives messages.
- Webhook
- Related: Subscription, Notification Topic
An HTTPS subscription endpoint that receives notification payloads, commonly used to open incident tickets or trigger automation when an alarm fires.
- APM Domain
- Related: Trace, Span, APM Agent
The top-level container in Application Performance Monitoring that holds traces, spans, and configuration for one application environment and defines its data upload credentials.
- Trace
- Related: Span, APM Domain
The complete record of one request as it travels across services, composed of nested spans. Traces reveal latency distribution and where failures originate in a distributed system.
- Span
- Related: Trace, APM Agent
A single timed operation within a trace, such as a database call or HTTP request, with start time, duration, attributes, and parent-child relationships to other spans.
- APM Agent
- Related: APM Domain, Span
The library or collector that instruments an application, captures spans, and uploads them to an APM domain using a data key and private endpoint.
- Synthetic Monitor
- Related: Synthetic Monitoring, Availability Monitoring
An APM or Monitoring resource that runs scripted browser or network tests on a schedule to validate availability and performance from external locations.