librato/appoptics-agent-docker

Name: appoptics-agent-docker

Owner: Librato

Description: Docker and Kubernetes assets for running AppOptics

Created: 2018-04-20 14:37:40.0

Updated: 2018-04-20 14:37:42.0

Pushed: 2018-04-30 11:37:23.0

Homepage:

Size: 41

Language: Shell

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

appoptics-agent-docker

Docker and Kubernetes assets for running AppOptics

About

This repo contains a Docker image for running the AppOptics agent.

This can be used to monitor Kubernetes clusters with the two Kubernetes assets in this repo:

• Deployment - A single pod to talk to the Kubernetes API to send Kubernetes specific metrics to AppOptics.
• DaemonSet - A DaemonSet that runs a pod on every node in your cluster and publishes HostAgent and Docker metrics to AppOptics.

Or you can use this in sidecar fashion to run the other AppOptics Integrations.

Installation

Deployment

If you're using RBAC on your Kubernetes cluster you'll need to deploy the Service Account first so that the agent can talk to your Kubernetes API:

ctl apply -f appoptics-agent-serviceaccount.yaml    

To deploy the Deployment to Kubernetes, update the APPOPTICS_TOKEN environment variable in appoptics-agent-deployment.yaml and run:

ctl apply -f appoptics-agent-deployment.yaml

Enable the Kubernetes plugin in the AppOptics UI and you should start seeing data trickle in.

DaemonSet

To deploy the DaemonSet to Kubernetes, update the APPOPTICS_TOKEN environment variable in appoptics-agent-daemonset.yaml and run:

ctl apply -f appoptics-agent-daemonset.yaml

Enable the Docker plugin in the AppOptics UI and you should start seeing data trickle in.

Sidecar

If you wanted to run this on Kubernetes as a sidecar for monitoring specific services, you can follow the instructions below which use Zookeeper as an example.

Add a second container to your deployment YAML underneath spec.template.spec.containers and the agent should now have access to your service over localhost:

me: zookeeper-ao-sidecar
age: 'appoptics/appoptics-agent-docker:v0.1'
v:
- name: APPOPTICS_TOKEN
  value: APPOPTICS_TOKEN
- name: APPOPTICS_ENABLE_ZOOKEEPER
  value: 'true'
- name: APPOPTICS_DISABLE_HOSTAGENT
  value: 'true'

Configuration

Environment Parameters

The following environment parameters are available:

Parameter | Description —————————–|——————— APPOPTICS_TOKEN | Your AppOptics token. This parameter is required. LOG_LEVEL | Expected value: DEBUG, INFO, WARN, ERROR or FATAL. Default value is WARN. APPOPTICS_HOSTNAME | This value overrides the hostname tagged for default host metrics. The DaemonSet uses this to override with Node name. APPOPTICS_ENABLE_DOCKER | Set this to true to enable the Docker plugin. APPOPTICS_ENABLE_KUBERNETES | Set this to true to enable the Kubernetes plugin. APPOPTICS_DISABLE_HOSTAGENT | Set this to true to disable the Host Agent system metrics collection. APPOPTICS_ENABLE_ZOOKEEPER | Set this to true to enable the Zookeeper plugin.

Development

The included Kubernetes resources rely on a Docker image from Docker Hub, see the Dockerfile for more details. You can build and push this by running:

er build -t appoptics/appoptics-agent-docker:v0.1 .
er push appoptics/appoptics-agent-docker:v0.1