gici/newrelic-plugin-agent-docker repository overview

⁠newrelic-plugin-agent-docker

This repository contains Dockerfile of newrelic-plugin-agent⁠ for Docker⁠'s automated build⁠ published to the public Docker Hub Registry⁠.

It will monitor instances of services supported by newrelic-plugin-agent⁠ that were configured by the user or will try to automatically monitor supported instances running inside docker containers on the same machine.

⁠Base Docker Image

• gici/python⁠

⁠Installation

1. Install Docker⁠.

2. Download automated build⁠ from public Docker Hub Registry⁠: docker pull gici/newrelic-plugin-agent-docker

   (alternatively, you can build an image from Dockerfile: docker build -t="gici/newrelic-plugin-agent-docker" github.com/devsenexx/newrelic-plugin-agent-docker)

⁠Usage

docker run -d --net=host -v /var/run/docker.sock:/var/run/docker.sock:ro -e NEWRELIC_KEY="YOUR_KEY" gici/newrelic-plugin-agent-docker

⁠service discovery

automatic service discovery is done in the following order:

1. search for images tagged with "com.newrelic.plugin" and check if there's a default backend by that name

2. search for containers that are named like one of the default backends

⁠Attach custom backend configuration

1. Create a mountable data directory <data-dir> on the host.

2. Create a backend configuration file at <backends-dir>/<backend_name>.yml. for example, create an elasticsearch configuration file at <backends-dir>/elasticsearch.yml:

name: my-elasticsearch-cluster
host: localhost
port: 9200
scheme: http

1. Start a container by mounting data directory and specifying the custom configuration file:

docker run -d --net=host -v /var/run/docker.sock:/var/run/docker.sock:ro -v <backends-dir>/backends:/etc/newrelic/backends -e NEWRELIC_KEY="YOUR_KEY" gici/newrelic-plugin-agent-docker