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 find out what 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.
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. |
|
SearchSuccess
|
Search Success | Count | Number of successful search queries issued by the user. |
|
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
- Open the navigation menu and click Observability & Management. Under Logging, click Logs.
- Under List scope, Compartment, choose a compartment you have permission to work in.
- Under Log name, click the name of the log you want to view. The log detail page opens.
-
In the Resources menu, click Metrics.
The Metrics page displays a default set of charts for the log.
- Open the navigation menu and click Observability & Management. Under Logging, click Log Groups.
- Under List scope, Compartment, choose a compartment you have permission to work in.
- Under Log Group, click the name of the log group you want to view. The log group detail page opens.
-
In the Resources menu, click Metrics.
The Metrics page displays a default set of charts for the log group.
- Open the navigation menu and click Observability & Management. Under Monitoring, click Service Metrics.
-
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.
Using the API
- Monitoring API for metrics and alarms
- Notifications API for notifications (used with alarms)