Expand Monitoring with Telegraf

Telegraf allows you to add support for collecting metrics with minimal memory footprint.

Telegraf is a plugin-driven agent used to collect, process, aggregate, and output metric data. Using Telegraf expands the scope of Oracle Infrastructure Monitoring by increasing the number and type of metrics that can be collected via Telegraf’s large and ever increasing plugin library.

Enabling Telegraf for Oracle Management Cloud involves configuring Telegraf to send metric data to the cloud agent. Telegraf metrics can be automatically mapped to Oracle Management Cloud metrics with a new entity type created for each input plugin.

Note:

Telegraf integration with requires Oracle Management Cloud agent version 1.40 or greater.

When viewing these auto-created entities from the Oracle Management Cloud console, you can determine whether Oracle Management Cloud is receiving the Telegraf metrics through the following entity availability states:

UP: Oracle Management Cloud is receiving metrics from Telegraf.
DOWN: Oracle Management Cloud is not receiving metrics from Telegraf.

You can modify these auto-created entity types via REST API.

Note:

REST API documentation access is currently limited to approved customers. Contact your Oracle Support or Sales Representative for more information about accessing and using REST API documentation.

Auto-created entities require a Standard Edition/Enterprise Edition license. For more information, see Enabling License Editions for Oracle Management Cloud and Oracle Management Cloud Offerings.

The following steps illustrate how to use Telegraf with Oracle Management Cloud. All steps are required.

Step	Illustrative Example
1. Configure input plugins to read data into Telegraf.	Example Input Plugin: Processes Plugin
2. Configure Telegraf to send metrics to the cloud agent over HTTPS.	Example: Configure Telegraf for Oracle Management Cloud Integration
3. Add a generic metric collector entity representing the Telegraf agent to Oracle Management Cloud. This step is needed to map the availability status of Telegraf, its version, specify how the cloud agent should handle metrics sent by the Telegraf agent, etc.	Example Generic Metric Collector Entity (Telegraf)

Step

Illustrative Example

1. Configure input plugins to read data into Telegraf.

Example Input Plugin: Processes Plugin

2. Configure Telegraf to send metrics to the cloud agent over HTTPS.

Example: Configure Telegraf for Oracle Management Cloud Integration

3. Add a generic metric collector entity representing the Telegraf agent to Oracle Management Cloud.

This step is needed to map the availability status of Telegraf, its version, specify how the cloud agent should handle metrics sent by the Telegraf agent, etc.

Example Generic Metric Collector Entity (Telegraf)

If you don't see any metrics from Telegraf after performing the integration steps, see Troubleshooting Telegraf Metric Collection.