Skip to content

Latest commit

 

History

History
167 lines (125 loc) · 4.28 KB

README.md

File metadata and controls

167 lines (125 loc) · 4.28 KB
Raw

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"

or

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