Apigee Edge Private Cloud Monitoring can really be a dauting task. Apigee Supports JMX and you can use any of the JMX tools like JConsole to monitor system parameters. This projects brings you the monitoring with Grafana, Influx and Telegraf.
Apigee Monitoring
Influxdb is a time series database.
Please refer https://docs.influxdata.com/influxdb/v1.5/introduction/installation/ for installing influxdb. We are supporting influxdb 1.2.2+.
Requirements
- CPU: 2 Core
- RAM: 4 GB
- Disk: 500 GB SDD, 3000 IOPS.
In case you are using RHEL/Centos, you can install with following commands -
curl -O https://dl.influxdata.com/influxdb/releases/influxdb-1.5.3.x86_64.rpm
sudo yum localinstall influxdb-1.5.3.x86_64.rpm
Enable and Start influxdb
systemctl enable influxdb
systemctl start influxdb
Once influxdb is installed, Go to the influx terminal to create initial databases
influx
Connected to http://localhost:8086 version 1.5.3
InfluxDB shell version: 1.5.3
>
- Show databases
> SHOW databases
name: databases
name
----
_internal
- Create databases - system,events, application
> CREATE database application
> CREATE database system
> CREATE database events
> SHOW databases
name: databases
name
----
_internal
system
events
application
> exit
Grafana UI allows visual representation of events and metrics. In this case we will import some pre baked dashboards that will give some useful insights into Apigee.
Please refer to http://docs.grafana.org/installation/rpm/ for installing grafana. You can install grafana on management server node or any other nodes.
- Add the following to a new file at /etc/yum.repos.d/grafana.repo
[grafana]
name=grafana
baseurl=https://packagecloud.io/grafana/stable/el/7/$basearch
repo_gpgcheck=1
enabled=1
gpgcheck=1
gpgkey=https://packagecloud.io/gpg.key https://grafanarel.s3.amazonaws.com/RPM-GPG-KEY-grafana
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
- Install Grafana as follows
sudo yum install grafana
- Start the server (via systemd)
sudo systemctl daemon-reload
sudo systemctl start grafana-server
sudo systemctl status grafana-server
- Enable the systemd service to start at boot
sudo systemctl enable grafana-server.service
Create 3 datasources : application-dc-1 , system-dc-1 and events-dc-1 and point them to application, system and events database of influx.
- name: application-dc-1
- type : Choose the type to influxDB
- HTTP URL : This is the influxdb machines ip address. The default port is 8086.
- Influx DB Details: -- Database : application -- User: root -- Password: root
Application Data Source
Events Data Source
System Data Source
Import All the Pre built dashboards provided this sample. You can also build your own dashoards.Upload the json file from the UI as given below.
Import Dashboards
Telegraf is the collection agent that collects all metrics from all apigee components.
Install telegraf agent on all apigee nodes which needs monitoring.
cat <<EOF | sudo tee /etc/yum.repos.d/influxdb.repo
[influxdb]
name = InfluxDB Repository - RHEL \$releasever
baseurl = https://repos.influxdata.com/rhel/\$releasever/\$basearch/stable
enabled = 1
gpgcheck = 1
gpgkey = https://repos.influxdata.com/influxdb.key
EOF
- Copy telegraf.conf from samples provided telegraf/telegraf.conf to /etc/telegraf/telegraf.conf in the host.
- Edit /etc/telegraf/telegraf.conf and replace 127.0.0.1 with ip address of influxdb server.
- Copy relevant toml files present in telegraf/telegraf.d/ to /etc/telegraf/telegraf.d/ directories based on the apigee component running on that node. For ex: If node is running apigee cassandra and apigee zookeeper only, copy apigee-cassandra.toml and apigee-zookeeper.toml to /etc/telegraf/telegraf.d/ If management server is running copy edge-management-server.toml.
sudo yum --disablerepo=influxdb install telegraf
sudo systemctl start telegraf
sudo systemctl enable telegraf
sudo systemctl status telegraf
You can now browse the UI through http://grafanaIPorDNS:3000
Login Creds
- user : admin
- password: admin
Hurry!!! You have just setup basic monitoring.