Plugins 〉Oracle Cloud Infrastructure Metrics


Developer

Oracle

Resources


Sign up to receive occasional product news and updates:



Data Source
commercial

Oracle Cloud Infrastructure Metrics

  • Overview
  • Installation
  • Change log
  • Related content

About OCI Metrics plugin for Grafana

Introduction

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:

  • In case you are migrating from a previous version (3.x.x or below) of the OCI Metrics Grafana Plugin and are not using Instance Principals (Environment not set as OCI instance), please refer to the Migration Instructions for Grafana OCI Metrics Data Source Settings (User Principals and Single Tenancy mode only) because you will have to reconfigure the plugin setup
  • In case you are migrating from a previous version (4.x.x or below) of the OCI Metrics Grafana Plugin to version 5.x.x and your dashboard is using dimensions in its selectors or as its template variables, please refer to this section to modify your dashboard accordingly to the new dimensions selector.

Oracle Cloud Infrastructure Metrics plugin is datasource with backend type of Grafana plugin. Hereafter referred to as OCI Metrics plugin.

Installation

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.

Note 1

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.

Note 2

The OCI Metrics plugin supports the integration with Grafana Cloud with Data Source Environment configured as local. See this document for additional information.

Debugging

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'

Documentation

Please refer to the docs folder in this repo

Help

Issues and questions about this plugin can be posted as an issue in this GitHub repository

Contributing

This project welcomes contributions from the community. Before submitting a pull request, please review our contribution guide

Security

Please consult the security guide for our responsible security vulnerability disclosure process.

License

Copyright (c) 2024 Oracle and/or its affiliates.

Released under the Universal Permissive License v1.0 as shown at

https://oss.oracle.com/licenses/upl/.

Installing Oracle Cloud Infrastructure Metrics on Grafana Cloud:

For more information, visit the docs on plugin installation.

<a name="v6.0.2"></a>

Security Maintenance release (v6.0.2) - 14 Oct 2024

This release includes:

  • security patches
  • Added new regions

Changes

<a name="v6.0.1"></a>

Security Maintenance release (v6.0.1) - 03 Oct 2024

This release includes:

  • security patches

Changes

<a name="v6.0.0"></a>

Security Maintenance release (v6.0.0) - 16 Sep 2024

This release includes:

  • security patches
  • React 18 upgrades
  • Support for Grafana 11
  • new regions added
  • golang and typescript libraries updates

Changes

<a name="v5.5.1"></a>

Security Maintenance release (v5.5.1) - 03 Jul 2024

This release includes:

  • few security patches
  • bug fix in multiple tenancy test function

Changes

<a name="v5.5.0"></a>

Alert enabled and Cross Tenancy support (v5.5.0) - 15 May 2024

This release includes:

  • Alert support
  • Cross Tenancy Support in instance principal mode
  • bug fixes
  • security fixes

Changes

<a name="v5.5.0-beta-unsigned"></a>

Beta release which includes alerting support (v5.5.0-beta-unsigned) - 24 Apr 2024

************* WARNING ***********

This is a BETA release unsigned. It means is still not final, not ready for production and not signed. You must enable following option in grafana.ini in order to use this version: app_mode = development This version is NOT available in the Grafana catalogue yet, you need to manually install the plugin unzipping the binaries in your grafana plugin directory.


This beta includes alerting function.

Changes

<a name="v5.2.0"></a>

Multi region support and interval enhanced (v5.2.0) - 16 Apr 2024

This release includes:

  • Multi Region support
  • use of interval as template var
  • Auto interval setting
  • security fix in package babel-traverse, vulnerable to CVE-2023-45133
  • enhanced error handling
  • improved performances on queries

Changes

<a name="v5.1.1"></a>

Regex fix and Sovereign cloud support (v5.1.1) - 08 Mar 2024

Implements the following:

  • Regex fix when using Compartments in Template vars
  • Sovereign Cloud Support
  • Explore issue when using Grafana version above v10.1

Changes

<a name="v5.1.0"></a>

Compartment regex fix and added new Sovereign regions (v5.1.0) - 07 Mar 2024

  • Compartment regex fix.
  • Added new Sovereign regions

Changes

<a name="v5.0.4"></a>

Added new regions for Data-source configuration (v5.0.4) - 20 Feb 2024

  • Added new missing regions in Datasource Configuration
  • Fixed a small bug in data source configuration page(src/ConfigEditor.tsx)

Changes

<a name="v5.0.3"></a>

Improved custom label management (v5.0.3) - 18 Jan 2024

This maintenance release includes:

Fix list of dimensions returned values from oci API in case of raw queries Fix sorting bug in case custom labels are used for non-indexed dimensions (for example for oci_autonomous_database)

Changes

<a name="v5.0.2"></a>

Raw query template vars (v5.0.2) - 10 Jan 2024

Raw query template vars

Changes

<a name="v5.0.1"></a>

Raw Mode and Custom metrics labeling (v5.0.1) - 09 Jan 2024

  • Support for labeling on some custom metrics
  • Support for Raw query mode
  • Bug fixes and security fixes

Changes

<a name="v5.0.0"></a>

Grafana 10 support (v5.0.0) - 11 Oct 2023

  • FE completely rewritten in React/Typescript
  • Compatibility with Grafana 10
  • Caching of region, tenancy, compartments, dimensions queries
  • many performance improvements
  • new Grafana API

Changes

<a name="v4.0.1"></a>

Upgrade nodejs dependencies and fix minor security bugs (v4.0.1) - 11 Apr 2023

  • Upgraded nodejs dependencies
  • Upgraded net golang libraries

Changes

<a name="v4.0.0"></a>

Multi-tenancy support and Secure JSON for OCI (v4.0.0) - 07 Mar 2023

This release features

  • Multi-tenancy support
  • Secure JSON secrets for OCI Configuration
  • Added support for San Jose region

Changes

<a name="v3.0.6"></a>

Region list sort, Customization of labels, ARM64 support, Namespace drop-down field bug fix and vulnerability patches (v3.0.6) - 24 Oct 2022

  • Customization of Graph labels (https://github.com/oracle/oci-grafana-metrics/pull/131)
  • OCI region list sorted in alphabetical order (https://github.com/oracle/oci-grafana-metrics/pull/132)
  • Updated GoLang and Javascript libraries, vulnerability patches (https://github.com/oracle/oci-grafana-metrics/pull/133, https://github.com/oracle/oci-grafana-metrics/pull/134, https://github.com/oracle/oci-grafana-metrics/pull/136, https://github.com/oracle/oci-grafana-metrics/pull/137, https://github.com/oracle/oci-grafana-metrics/pull/138, https://github.com/oracle/oci-grafana-metrics/pull/139, https://github.com/oracle/oci-grafana-metrics/pull/140)
  • Metrics Namespace drop-down field bug fix (https://github.com/oracle/oci-grafana-metrics/pull/135)
  • ARM64 support (https://github.com/oracle/oci-grafana-metrics/pull/129)

Changes

<a name="v3.0.5"></a>

v3.0.5 - Added new regions - 16 Jun 2022

New regions added:

  • Singapore
  • Paris
  • Queretaro

Update Grunt version. Update Linux readme.

Changes

<a name="v3.0.4"></a>

Minor patch (v3.0.4) - 16 Mar 2022

Update build files, plugin.json

Changes

<a name="v3.0.3"></a>

Bugfix for template variables (v3.0.3) - 11 Feb 2022

Fixes issue with multiple data sources and template variables.

Changes

<a name="v3.0.2"></a>

Grafana 8 hotfix support (v3.0.2) - 10 Feb 2022

Stopgap solution for Grafana 8 support which may not be fully polished. Full support will be released later.

Changes

<a name="v2.2.4"></a>

UK Gov support added and dev changes (v2.2.4) - 09 Aug 2021

  • Added support for uk gov regions uk-gov-london-1 , uk-gov-cardiff-1

Dev changes :

  • Removed toml file and replaced it with mod
  • Added some for installation and signing.

For oracle grafana developers In the next release : Append the following to the build script zip -r oci-grafana-metrics-<VERSION> ./dist

Changes

<a name="v2.2.3"></a>

Missing metrics fixed (v2.2.3) - 22 Jan 2021

In test phase, please don't use in production

  • Now, all the metrics are being received.
  • The metrics request is 20x faster now.
  • Signed the plugin and added to tar file.

Changes

<a name="v2.2.2"></a>

Fixed documentation w.r.t resource group (v2.2.2) - 11 Jan 2021

  • Fixed documentation with resource group in each query

Changes

<a name="v.2.2.1"></a>

Added support for dubai, santiago and cadiff (v.2.2.1) - 22 Dec 2020

This release adds support to new regions such as santiago, cardiff and dubai

Changes

<a name="v2.2"></a>

ap-chiyoda-1 support added (v2.2) - 08 Dec 2020

  • Supports calling Oracle Cloud Infrastructure services in the ap-chiyoda-1 region

Changes

<a name="2.0.2"></a>

Metrics plugin for grafana support (2.0.2) - 05 Oct 2020

  • Please download only the plugin file

  • This is not for all users

  • Please generate the manifest file and send us back in email

  • The version has been updated to 2.0.0 in plugin.json

Changes

<a name="v2.0.1"></a>

Logging-plugin-zip (v2.0.1) - 05 Oct 2020

  • Not for all all users
  • This is not associated with the current code
  • Download only plugin.tar and other
  • Only for grafana support

Changes

<a name="v2.0.0"></a>

v2.0.0 - 28 Sep 2020

  • Updated name and id of the plugin.

  • Please remove the existing plugin and install this version

  • There is no functional change.

Changes

<a name="v1.1.2"></a>

Support Grafana 7 (v1.1.2) - 07 Jul 2020

  • Update docs for Grafana 7
  • Expand the default region list.
  • Fix resolution Input

Changes

<a name="v1.1.1"></a>

List metrics api call fix (v1.1.1) - 04 Jun 2020

  • Now, the number of list metrics call has been set to a maximum of 20 pages
  • The limit is configurable

Changes

<a name="v1.1.0"></a>

Support added for variables and auto in window & resolution (v1.1.0) - 06 Apr 2020

New Features

  • Support added for variables and auto in window & resolution
Minor bug fixes
  • Fixed variable duplication in dropdowns
Documentation
  • Instructions added for using variables and auto-config in window and resolution of drop down

Changes

<a name="V1.0.9"></a>

Added a region option to getCompartment method (V1.0.9) - 12 Mar 2020

When OCI tenancy is provision with a single region, say 'us-phoenix-1' (home tenancy) and the datasource setting with local has the default regions as 'us-ausburn-1' (in the ~/.oci/config file), the getCompartment does not return the compartment list. The reason being the OCI tenancy has only one tenancy as home and that is not the 'us-phoenix-1' tenancy.

The fix is to set region to the home regions of the OCI tenancy, while making the getCompartment call.

Thanks Jayesh Patel

Changes

<a name="V1.0.8"></a>

Support Resource Group (V1.0.8) - 10 Mar 2020

User will be able to use Resource Group. By Default: No Resource Group

Changes

<a name="V1.0.7"></a>

V1.0.7 - 21 Feb 2020

Fix populated Metric Fields based on the selected region.

Changes

<a name="V1.0.6"></a>

Support hard coded values in template variables (V1.0.6) - 23 Jan 2020

  1. Support hard coded values in template variables
  2. Fix bug with filtering compartments by regex in template variable editor

Changes

<a name="V1.0.5"></a>

Manual query support. New template variables for dimensions. (V1.0.5) - 25 Nov 2019

  1. New template variables were added:
  • dimensions() which show all possible dimension keys for selected region, compartment, namespace and metric
  • dimensionOptions() which show all possible dimension values for selected region, compartment, namespace, metric and dimension key.
  1. Dimension value variable can be used as multi-value. Separate queries are generated for each dimension value out of multi-select (but no more than 20 queries)

  2. Custom query is supported. User can type MQL expression manually which will be passed to telemetry instead of selected on the UI metric and dimensions.

  3. Custom template variables were added to the list of dimension value options. Duplicate options are removed.

  4. Options for regions and compartments are cached while query editor is open. Dimension options are cached for the selected region - compartment - namespace - metric.

Changes

<a name="V1.0.4"></a>

Fix $namespace and $metric variables (V1.0.4) - 03 Oct 2019

$namespace In the previous version, the list of namespaces was hardcoded for the $namespace variable. Today the list of namespaces depends on region and compartment.

$metric In the previous version, the $metric variable depends on the home region, $compartment and hardcoded $namespace. Today $metric depends on $region, $compartment and $namespace.

Changes

<a name="V1.0.3"></a>

V1.0.3 - 25 Sep 2019

Fix issue: Metric name rule creation updated

Changes

<a name="v1.0.2"></a>

v1.0.2 - 27 Mar 2019

  • Shows subcompartments and removes inactive compartments from that list
  • Changes Metric names when rendering on the screen, uses a human readable name for the resource if one is present
  • Shortens ocids to first three and last six characters to save screen real estate

Changes

<a name="v1.0.1"></a>

v1.0.1 - 08 Mar 2019

Pulls in regions dynamically Adds more documentation

Changes

<!-- Generated by https://github.com/rhysd/changelog-from-release v3.7.2 -->