wikiwi/stackdriver-agent repository overview

⁠stackdriver-agent

Warning: This is an early alpha version without commitment for backwards compatibility.

This projects packs the stackdriver agent⁠ in a Docker Container with easy to use configuration based on Environment Variables. No other metrics other than those configured through the Environment Variables are collected by the agent.

⁠Environment Variables

The symbol # represents a continuous number starting at 0

⁠Google Cloud Platform

For authorization information read the official documentation⁠.

⁠Example

# Monitor nginx
docker run -e NGINX_STATUS_URL=http://my-nginx:8080/nginx_status \
           wikiwi/stackdriver-agent

# Monitor host
docker run -e MONITOR_HOST=true -v /proc:/mnt/proc:ro --privileged \
           wikiwi/stackdriver-agent

⁠Running in a Kubernetes Cluster in GKE

To ensure that the agent is running on each one of your nodes in a Kubernetes cluster managed by GKE, deploy the agent as a DaemonSet by adjusting the example stackdriver-agent.yml file to your needs:

## stackdriver-agent.yml ##
apiVersion: extensions/v1beta1
kind: DaemonSet
metadata:
  name: stackdriver-agent
spec:
  template:
    metadata:
      labels:
      app: stackdriver-agent
    spec:
      containers:
      - name: stackdriver-agent
        image: wikiwi/stackdriver-agent
        securityContext:
          privileged: true
        volumeMounts:
        - mountPath: /mnt/proc
          name: procmnt
        env:
          - name: MONITOR_HOST
            value: "true"
      volumes:
      - name: procmnt
        hostPath:
          path: /proc

Where additional parameters (such as redis monitoring) can be enabled / disabled by adding or removing key/value pairs inside the env field.

*Note: If you want to disable host monitoring, remove the respective key/value pair as well as the securityContext, volumeMounts, and volumes fields.