In the ever-evolving landscape of cloud computing, the ability to efficiently log, monitor, and manage resources has become a cornerstone of operational success. At the heart of this intricate ecosystem are OCI agents such as Oracle Cloud Agent, Oracle Management Agent, and Unified Monitoring Agent. They emerge as crucial players in ensuring observability and management are seamless and tightly integrated with OCI cloud resources. In this blog, I will explain how this infrastructure comes together to meet your observability and management needs for a broad range of use cases.
OCI Observability & Management Reference Architecture

OCI Agents Overview
Oracle Cloud Infrastructure agents come in various forms, each designed with a specific set of capabilities to address different use cases. However, while these agents offer powerful functionalities, navigating the landscape and choosing the right agent for your unique requirements can sometimes be a daunting task. This overview aims to shed light on the types of OCI agents available, their key features, and how to approach selecting the most suitable agent for your use cases.
OCI Agents Comparison
Categories | Oracle Cloud Agent | Oracle Management Agent | Oracle Unified Monitoring Agent |
---|---|---|---|
Monitoring | via Compute Instance Monitoring Plugin | N/A | N/A |
Logging | via Unified Monitoring Agent Plugin | N/A | Integration with Loggin Service via User Principal |
Logging Analytics via | via Management Agent Plugin via | via Logging Analytics Plugin | N/A |
Stack Monitoring via | via Management Agent Plugin via | a Stack Monitoring Plugin | N/A |
Database Management via | via Management Agent Plugin via | via Database Management Plugin | N/A |
Operations Insights | via Management Agent Plugin | via Operations Insights Plugin | N/A |
Java Usage Tracking | via Management Agent Plugin | via Java Usage Tracking Plugin | N/A |
Java Management Service | via Java Management Service Plugin | via Java Management Service Plugin | N/A |
OS Management Hub | via OS Management Service Plugin | via OS Management Hub Plugin | N/A |
Agent Installation | Preinstalled for OCI compute, manual installation(zip, rpm) | Manual installation(zip, rpm) | Manual installation(zip, rpm) |
Authentication/Authorization | Resource Principal, Instance Principal | Resource Principal, Instance Principal | User Principal |
Agent Management | Fully Integrated | Fully Integrated | Partially Integrated, no UI |
Compute Instance Support | Yes | Yes | Yes |
Oracle Base Database Service Support | No | Yes | Yes* |
Oracle Exadata Database Service Dedicated Support | No | Yes | Yes* |
* NOTE: The Unified Monitoring Agent can be installed in the Oracle Base Database system or ExaDB-D VMs. Unified Monitoring Agent can send custom logs to OCI Logging Service. However, the open-source fluentd agent doesn’t support parsing Oracle database logs(for instance alert logs, trace files, listener logs, Grid Infrastructure logs, etc). Raw database logs will be presented in OCI Logging Service.
Oracle Cloud Agent manages Oracle Cloud Agent plug-ins and more
- Oracle Cloud Agent is a lightweight process that manages plugins running on compute instances. Oracle Cloud Agent plugins collect host logs and performance metrics, install OS updates, and perform other instance management tasks. Oracle Cloud Agent is installed by default for OCI compute instances.
- Oracle Cloud Agent supports the Platform Images For unsupported OS version, Oracle Management Agent and Unified Monitoring Agent can be used for collecting log and cloud resource data for OCI Observability and Management services.
- Oracle Cloud Agent manages the following plugins for the OCI Observability and Management, it is considered as the best practice to use Oracle Cloud Agent whenever it is possible.

Name | Description |
---|---|
Bastion | Allows secure shell (SSH) connections to an instance without public IP addresses using the Bastion service. |
Block Volume Management | Configures Block Volume sessions for the instance. |
Compute Instance Monitoring | Emits metrics about the instance’s health, capacity, and performance. These metrics are consumed by the Monitoring service. Enable Monitoring for Compute instances. |
Compute Instance Run Command | Running commands and scripts within the instance to remotely configure, manage, and troubleshoot the instance. |
Custom Logs Monitoring | Ingests custom logs into the Logging service. |
Management Agent collects | Collects data from resources such as OSs, applications, and infrastructure resources for Oracle Cloud Infrastructure services that are integrated with Management Agent. Data can include observability, log, configuration, capacity, and health data. |
Oracle Autonomous Linux | Manages autonomous updates and collects data associated with events, including logs and stack traces, for instances managed by the Autonomous Linux service. |
Oracle Java Management Service | Monitors and performs Java Development Kit (JDK) lifecycle management for Java deployments on instances managed by the Java Management service. |
OS Management Service Agent manages | Manages updates and patches for the operating system environment on the instance. OS Management |
Vulnerability Scanning scans | Scans the instance for potential security vulnerabilities like OS packages that require updates. |
- Supported OS versions
- Windows-x86_64, Windows-x86
- Oracle Linux
- CentOS
- Ubuntu
- Oracle Cloud Agent Troubleshooting, When you work with a support engineer to troubleshoot issues with the Oracle Cloud Agent, you can generate diagnostic data for your agent, the tool will generate a TAR file with a name in the format oca-diag-<date>.<identifier>.tar.gz
- cd /usr/bin/ocatools
- sudo ./diagnostic
Further Reading about Oracle Cloud Agent
Oracle Management Agent provides low-latency interactive communication
- Oracle Management Agent is a service that provides low latency interactive communication and data collection between Oracle Cloud Infrastructure and IT targets. Oracle Management Agent has plugins integrated with O&M advanced services such as Logging Analytics, Database Management, Operations Insights, Java Management Service, Stack Monitoring, etc. Plugins can collect and ingest data from various cloud resources. Management Agent can be enabled as a plugin of the Oracle Cloud Agent or can be installed independently.

- Supported OS versions
- Windows-x86_64, Windows-x86
- Solaris-Sparc64
- Linux-x86_64, Linux-Aarch64
- Oracle Management Agent Troubleshooting, generate Management Agent diagnostic support bundle
- If Management Agent is enabled on the compute instance via Oracle Cloud Agent
- sudo -u oracle-cloud-agent /var/lib/oracle-cloud-agent/plugins/oci-management agent/polaris/agent_inst/bin/generateDiagnosticBundle.sh
- If Management Agent is deployed as a standalone installation
- sudo -u mgmt_agent /opt/oracle/mgmt_agent/agent_inst/bin/generateDiagnosticBundle.sh
- If Management Agent is enabled on the compute instance via Oracle Cloud Agent
Further Reading about Oracle Management Agent
Unified Monitoring Agent ingests custom logs to Oracle Logging Service
- Unified Monitoring Agent is a fluentd-based open-source agent to ingest custom logs such as syslogs, application logs, and security logs to Oracle Logging Service. With proper agent configuration, it allows you to control exactly which logs you want to collect, how to parse them, and more.
- Note: The Unified Monitoring Agent is a fully managed agent, and custom client configuration is not officially supported. For example, gathering logs from remote sources is not recommended, since doing so can have serious security implications (because the log source cannot be verified).
- Unified Monitoring Agent supports the following OS versions:
- Oracle Linux 7, Oracle Linux 8
- CentOS 7, CentOS Stream 8
- Windows Server 2012 R2, Windows Server 2016, Windows Server 2019
- Ubuntu 16.04, Ubuntu 18.04, Ubuntu 20.04
- Unified Monitoring Agent Troubleshooting
- Log location: /var/log/unified-monitoring-agent/unified-monitoring-agent.log
- You can also use journalctl to view system logs specific to the Unified Monitoring Agent unit
- unified-monitoring-agent.service
- unified-monitoring-agent_config_downloader.service
- unified-monitoring-agent_config_downloader.timer
- unified-monitoring-agent_restarter.path
- journalctl -u unified-monitoring-agent_config_downloader.service –since “2023-2-30 00:00:01” –until “2023-08-31 23:59:59”
Further Reading about Oracle Unified Monitoring Agent
Oracle Management Agent Use Cases
- Collect application custom logs into Logging Analytics
- Collect Oracle Base Database Systems logs or Exadata Database Service Dedicated alert log and trace files into Logging Analytics
- Collect Oracle Autonomous Database Serverless audit logs and data in tables/views into Logging Analytics
- Onboard on-prem Oracle Databases to Database Management Services or Operations Insights
- Onboard Oracle RAC databases to Database Management Service
- Collect Oracle Kubernetes Clusters metrics by deploying Management Agent Statefulset of replica one and Metric Server for collecting and pushing the metrics to OCI Monitoring.
Oracle Unified Monitoring Agent Use Cases
- Collect syslog and security logs into Logging Service to stream to third-party SIEM
- Collect Oracle Base Database Systems alert logs and trace files into Logging Service to send logs to external systems
- Collect Oracle Kubernetes Clusters pod logs, object logs, and syslogs into Logging Analytics using OCI Logging Analytics Fluentd output plugin fluent-plugin-oci-logging-analytics when it buffers into local file system, periodically creates payload and uploads it to OCI Logging Analytics.
Conclusion
Oracle Cloud Infrastructure agents are the unsung heroes of cloud management and monitoring. While they empower you with unprecedented control and visibility, selecting the right agent for your specific needs requires careful consideration. By understanding the types of agents available, assessing your environment, and evaluating features against your use cases, you can confidently navigate the agent landscape and make informed decisions that drive operational excellence within your Oracle Cloud environment.
Sign up for an Oracle Cloud Infrastructure free trial account today to try out new Oracle Cloud Infrastructure features!
Further Reading
- Oracle Cloud Agent Technical Details
- Oracle Cloud Agent Troubleshooting
- Oracle Management Agent Technical Details
- Unified Monitoring Agent Technical Details
- Unified Monitoring Agent Troubleshooting
- Set Up Continuous Log Collection From Your Hosts
- OCI Management Agent Helm Chart
- How to Collect Management Agent Diagnostic Bundle (Doc ID 2890347.1)
- Oracle Cloud Agent status showing invalid (Doc ID 2908911.1)