Cloud Eye Exporter

This document describe how to configure Flexible Engine Cloud Eye Services exporter for Prometheus.

Supported Services

Cloud Eye exporter for Prometheus support the following services :

Elastic Cloud Server
Elastic LoadBalancer
Elastic IP
Elastic Volume Service
NAT Gateway
Relational Database Service

Cloud Eye Exporter SDKv3 branch supports the following services :

Switch for branch SDKv3 for the following services support: SDKv3 Branch

Elastic Cloud Server (ECS)
Elastic LoadBalancer (ELB)
Elastic IP (EIP)
Elastic Volume Service (EVS)
NAT Gateway (NATG)
Relational Database Service (RDS)
Distributed cache service (DCS)
Direct Connect service (DCAAS)
Virtual private cloud (VPC)
Auto scaling service (AS)
FunctionGraph service (FGS)
Data replication service (DRS)
Document database service (DDS)
API Gateway (APIG)
Cloud backup and recovery (CBR)
Web application firewall (WAF)
Data lake insight (DLI)
Scalable file service (SFS)
Cloud data migration (CDM)
Distributed Database Middleware (DDMS)
GaussDB service (GaussDB)
AntiDDOS (DDOS)
Data warehouse service (DWS)
VPN service (VPN)
Bare metal server (BMS)
VPCEndpoiint service (VPCEP)
ModelArts service (ModelArts)
Graph engine service (GES)
MapReduce service (MRS)
Data lake governance service DGC (DAYU)
Database security service (DBSS)

Download

git clone https://github.com/FlexibleEngineCloud/cloudeye-exporter

(Optional ) Building The Exporter in Golang

wget https://dl.google.com/go/go1.12.5.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.12.5.linux-amd64.tar.gz
export PATH=$PATH:/usr/local/go/bin # You should put in your .profile or .bashrc
go version # to verify it runs and version #

go get github.com/FlexibleEngineCloud/cloudeye-exporter
cd ~/go/src/github.com/FlexibleEngineCloud/cloudeye-exporter
go build

Configure Exporter

First you need to customize the clouds.yml file to add your credentials :

Modify the "auth_url" value follwing your region (IAM API Endpoints list can be found here).

global:
  prefix: "flexibleengine"
  port: ":8087"

auth:
  auth_url: "https://iam.eu-west-0.prod-cloud-ocb.orange-business.com/v3"
  project_name: "eu-west-0_myproject"
  access_key: "<your-access-key>"
  secret_key: "<your-secret-key>"
  region: "eu-west-0"

auth:
  auth_url: "https://iam.eu-west-0.prod-cloud-ocb.orange-business.com/v3"
  project_name: "eu-west-0"
  user_name: "username"
  password: "password"
  region: "eu-west-0"
  domain_name: "domain_name"

Notes :

global.retrieve_offset (default "0") is an offset (example "-5m") to ask Cloudeye for some older metrics.
global.cloudeye_timestamp (default false) allows Cloudeye Exporter to send metrics with their Cloudeye timestamp
global.ignore_empty_datapoints (default false), when set, will ignore empty datapoints (no warnings)

Running

./cloudeye-exporter -config=clouds.yml

By default service is running on port 8087, default config file location is ./clouds.yml.

Visit metrics in http://localhost:8087/metrics?services=SYS.VPC,SYS.ELB

Help

Usage of ./cloudeye-exporter:
  -config string
        Path to the cloud configuration file (default "./clouds.yml")
  -debug
        If debug the code.

Prometheus Configuration

You need to edit Prometheus Configuration file

vim /etc/prometheus/prometheus.yml

Create a new job FlexibleEngine

Pass the The Cloud Eye Exporter address as targets

Add services to monitor (see supported services)

Example config:

global:
  scrape_interval: 1m # Set the scrape interval to every 1 minute seconds. Default is every 1 minute.
  scrape_timeout: 1m
scrape_configs:
  - job_name: 'FlexibleEngine'
    static_configs:
    - targets: ['10.0.0.10:8087']
    params:
      services: ['SYS.VPC,SYS.ELB']

Finally you need to restart Prometheus service

sudo systemctl restart prometheus

You can verify that FlexibleEngine targets is now available in Prometheus Targets