This plugin makes queries to the Oracle Cloud Infrastructure Monitoring Service and displays them on Grafana.
If you are running Grafana on a machine instance in Oracle Cloud, use the Service Principal with a configured Dynamic Group and policy to allow you to read metrics and compartments.
If you are running Grafana anywhere else, make sure you have ~/.oci
configured properly. You can do this by installing the Oracle Cloud CLI and
running the setup.
If you're using a version of Grafana that's older than 6.0, you will need to download the zip file and install this plugin manually, or chmod the binary that is downloaded to make it executable.
In order to simplify the installation process, we created detailed guides for you to follow:
- Install Grafana and the Oracle Cloud Infrastructure Data Source for Grafana on a Linux host using this document.
- Install Grafana and the Oracle Cloud Infrastructure Data Source for Grafana on a MacOS host using this document.
- Install Grafana and the Oracle Cloud Infrastructure Data Source for Grafana on a virtual machine in Oracle Cloud Infrastructure using this document.
- Install Grafana and the Oracle Cloud Infrastructure Data Source for Grafana on a virtual machine in Oracle Cloud Infrastructure using Terraform using this document.
- Install Grafana and the Oracle Cloud Infrastructure Data Source for Grafana on Kubernetes in Oracle Cloud Infrastructure using this document
Once you have the data source installed, configure your datasource with your tenancy OCID, default region, and where you're running the plugin (Oracle Cloud or elsewhere).
We also have documentation for how to use the newly installed and configured plugin in our Using Grafana with Oracle Cloud Infrastructure Data Source walkthrough.
Please make sure that the golang version installed is 1.16
and grafana version installed is < 8
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 foroci-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) 2021 Oracle and/or its affiliates.
Released under the Universal Permissive License v1.0 as shown at https://oss.oracle.com/licenses/upl/.