This plugin makes queries to the Oracle Cloud Infrastructure(OCI) Monitoring Service to fetch metrics for your OCI resources or your custom metrics in OCI. And then displays them on Grafana.
If you are running Grafana on a machine instance in Oracle Cloud, use the Instance Principal with a configured Dynamic Group and policy to allow you to read metrics and compartments.
If you are running Grafana anywhere else you'll need to get the necessary provider and resource settings, as described in this section Getting OCI Configuration values
Latest plugin version 5.X.X (available on Grafana Marketplace) is compatible with Grafana 10.
Breaking changes:
Oracle Cloud Infrastructure Metrics plugin is datasource with backend type of Grafana plugin. Hereafter referred to as OCI Metrics plugin.
Please refers to the following compatibility matrix to choose plugin version accordingly to your Grafana installation: Compatibility Matrix
In order to simplify the installation process, we created detailed guides for you to follow.
Install Grafana and the OCI Metrics plugin on a Linux host using this document.
Install Grafana and the OCI Metrics plugin on Grafana Cloud using this document.
Install Grafana and the OCI Metrics plugin on a MacOS host using this document.
Install Grafana and the OCI Metrics plugin on a virtual machine in Oracle Cloud Infrastructure using this document.
Install Grafana and the OCI Metrics plugin on a virtual machine in Oracle Cloud Infrastructure using Terraform using this document.
Install Grafana and the OCI Metrics plugin on Kubernetes in Oracle Cloud Infrastructure using this document
Once you have the OCI Metrics Plugin installed, configure your datasource with your tenancy OCID, default region, and right IAM setup(Dynamic Group or OCI User Auth with local Private key file on Grafana Server node-depending where you're running the Grafana-Oracle Cloud or elsewhere).
We also have documentation for how to use the newly installed and configured plugin in our Using Grafana with OCI Metric Plugin walkthrough.
If you're using a version of Grafana that's older than 6.0, you will need to download the zip file for plugin versions <=2.2.4 and install this plugin manually, or chmod the binary that is downloaded to make it executable.
The OCI Metrics plugin supports the integration with Grafana Cloud with Data Source Environment configured as local. See this document for additional information.
Please make sure that the golang version installed is 1.16 and grafana version installed is 8.x.x
If you want to debug golang backend plugin code, follow the steps below:
Install gops to list running go processes on your machine
Run gops and find processId for oci-plugin_darwin_amd64 process
Copy this processId to the .vscode/launch.json
In your VSCode from 'Debug' menu call 'Start Debugging'
Please refer to the docs folder in this repo
Issues and questions about this plugin can be posted as an issue in this GitHub repository
This project welcomes contributions from the community. Before submitting a pull request, please review our contribution guide
Please consult the security guide for our responsible security vulnerability disclosure process.
Copyright (c) 2024 Oracle and/or its affiliates.
Released under the Universal Permissive License v1.0 as shown at