Oracle Cloud Infrastructure Documentation

Logging Metrics

Review available Monitoring metrics for the Logging service.

You can monitor the health, capacity, and performance of your logs and log groups by using metrics , alarms , and notifications.

This topic describes the metrics emitted by the Logging service in the <oci_logging> metric namespace.

Resources: Service and custom logs.

Overview of the Logging Service Metrics

The Logging service metrics help you measure the number and type of connections between services in Oracle Cloud Infrastructure. You can use metrics data to diagnose and troubleshoot logging issues.

To view a default set of metrics charts in the Console, navigate to the log or log group you're interested in, and then click Metrics. You also can use the Monitoring service to create custom queries.

Prerequisites

IAM policies: To monitor resources, you must be granted the required type of access in a policy  written by an administrator, whether you're using the Console or the REST API with an SDK, CLI, or other tool. The policy must give you access to the monitoring services as well as the resources being monitored. If you try to perform an action and get a message that you don't have permission or are unauthorized, contact the administrator to determine the type of access you were granted and which compartment  you need to work in. For more information about user authorizations for monitoring, see IAM Policies (Monitoring).

Available Metrics: oci_logging

The metrics listed in the following table are automatically available for any logs you create. You do not need to enable monitoring on the resource to get these metrics.

Logging service metrics include the following dimensions :

logGroupId
The OCID of the log group that the metrics apply to.
logGroupName
The name of the log group that the metrics apply to.
logObjectId
The OCID of the log object that the metrics apply to.
logObjectName
The name of the log object that the metrics apply to.
logSourceService
The log source service that the metrics apply to (for example, "custom" or "flowlogs").
namespace
The namespace that the metrics apply to.
resourceId
The OCID of the resource that the metrics apply to.
Metric Metric Display Name Unit Description Dimensions
BytesIngested Bytes Ingested Bytes

Number of bytes read from the source.

resourceId

logObjectId

logObjectName

logGroupId

logGroupName

logSourceService

SearchSuccess Search Success Count Number of successful search queries issued by the user.

resourceId

logObjectId

logObjectName

logGroupId

logGroupName

logSourceService

CustomLogAcceptanceRate Custom Log Acceptance Rate Count The throttling rate for custom logs. See Viewing the Custom Logs Acceptance Rate for more information. resourceId

Using the Console

To view metric charts for a single log
  1. Open the navigation menu and click Observability & Management. Under Logging, click Logs.
  2. Under List scope, Compartment, choose a compartment you have permission to work in.
  3. Under Log name, click the name of the log you want to view. The log detail page opens.

  4. In the Resources menu, click Metrics.

    The Metrics page displays a default set of charts for the log.

To view metric charts for a single log group
  1. Open the navigation menu and click Observability & Management. Under Logging, click Log Groups.
  2. Under List scope, Compartment, choose a compartment you have permission to work in.
  3. Under Log Group, click the name of the log group you want to view. The log group detail page opens.

  4. In the Resources menu, click Metrics.

    The Metrics page displays a default set of charts for the log group.

To view default metric charts for multiple logs
  1. Open the navigation menu and click Observability & Management. Under Monitoring, click Service Metrics.

  2. For Metric namespace, select oci_logging.

    The Service Metrics page displays a default set of charts for the selected metric namespace. For more information about the emitted metrics, see Available Metrics: oci_logging. You can also use the Monitoring service to create custom queries.

For more information about monitoring metrics and using alarms, see Overview of Monitoring. For information about notifications for alarms, see Overview of Notifications.