How to Set Up OCI Monitoring

Connect your Oracle Cloud Infrastructure (OCI) account to Cloudmon using a read-only API key. Once connected, Cloudmon auto-discovers your Compute Instances and begins collecting metrics in real time.

Overview

Oracle Cloud Infrastructure (OCI) is Oracle's cloud platform, providing hosted compute, storage, networking, and database services over the internet. Organisations use OCI to run workloads without managing physical hardware, with resources deployed across Oracle's global network of data centres.</p> <p>This guide walks you through connecting your OCI account to Cloudmon for the first time. The setup involves generating an API key for a user in the OCI console, followed by entering that user's credentials into Cloudmon. Once complete, Cloudmon will have read-only access to your OCI tenancy and will automatically discover your Compute Instances.

Prerequisites

Before you begin, ensure the following are in place:

How It Works

Cloudmon connects to your OCI tenancy using an API key associated with a specific OCI user. This key is used to authenticate read-only API calls to OCI on a recurring schedule, pulling Compute Instance metrics, resource lists, and configuration data. Nothing is installed inside your OCI environment, and no Cloudmon probe is required: the connection is made directly from the Cloudmon Controller using the credentials you provide.

Configuration Steps

Step 1: Identify the User and Compartment

Decide which OCI user's API key Cloudmon will use, and which compartment holds the Compute Instances to be monitored. Note down the following from the OCI console, you will need these in Step 3:

• User OCID: found on the user's details page under Identity & Security → Users → [select user]
• Compartment OCID: found on the compartment's details page under Identity & Security → Compartments → [select compartment]

Step 2: Generate an API Key

Follow the Oracle documentation to generate an API signing key pair for the user identified in Step 1 and upload the public key in the OCI console: How to Generate an API Signing Key, Oracle documentation

Once the key is added, note down the following, you will need these in Step 3:

• Fingerprint: shown next to the API key once it is added under the user's API Keys section
• Private key file (.pem): the private key file generated alongside the public key, downloaded to your machine during key creation

Important: The private key file is only available to download at the time it is generated. Store it securely; you will need to upload it into Cloudmon in Step 3.

Step 3: Add Your OCI Account in Cloudmon

1. Log in to your Cloudmon dashboard
2. Navigate to Cloud → OCI → Add OCI Account
3. The Add OCI panel opens, organized into four sections: Monitor Details, Discovery Settings, Resource Management, and Configuration Details

Monitor Details: basic details and connection credentials.

Discovery Settings: services and discovery settings.

Resource Management: monitoring options.

Configuration Details: groups and tags.

Alert Settings: notification and alert configuration.

4. Click Save
5. Cloudmon will validate the credentials and begin discovering OCI Compute Instances in the selected region and compartment

Step 4: Verify the Connection

After saving, navigate to Cloud → OCI → [Your Account]. If the connection is successful, your discovered OCI Compute Instances will begin populating within a few minutes. If resources do not appear, use the Rediscover button on the account page to trigger a manual scan.

Troubleshooting