Public Repository

Last pushed: a month ago
Short Description
Netuitive Agent Docker image
Full Description

Quick Start

You just need to set your hostname and APIKEY in the environment.

docker run -d -e DOCKER_HOSTNAME="my-docker-host" -e APIKEY="my-api-key" --name netuitive-agent -v /proc:/host_proc:ro -v /var/run/docker.sock:/var/run/docker.sock:ro netuitive/docker-agent

Running the docker-agent with StatsD server

The only necessary configuration is the hostname and your APIKEY. You can run the agent with the following command:

docker run -d -p 8125:8125/udp --name netuitive-agent -e DOCKER_HOSTNAME="my-docker-host" -e APIKEY="my-api-key" -v /proc:/host_proc:ro -v /var/run/docker.sock:/var/run/docker.sock:ro netuitive/docker-agent

Configuration

There are a few parameters that can be changed with environment variables.
You can change the settings by adding -e <VARIABLE>=<VALUE> from the table below, to the command line when launching the container

Variable Description
LOGLEVEL change the log level of the agent. -e LOGLEVEL=DEBUG for example would set the agent to log at DEBUG level.
INTERVAL interval in seconds the agent collectors run. -e INTERVAL=120 for example would set them to 2min intervals.
DOCKER_HOSTNAME hostname of the docker host. -e DOCKER_HOSTNAME="my-docker-host" would set the hostname to my-docker-host.
APIKEY api key used to send data to Netuitive. -e APIKEY=myapikey would set the apikey to myapikey.
USE_LOCAL_CONFIG is used to tell the agent to ignore any environment variables set and use a local config file. See "Using Local Config" below. -e USE_LOCAL_CONFIG=true would enable this feature.
LPRT is used to tell the statsd agent what UDP port to listen on. (8125 by default)
FORWARD is used to enabled forwarding from the netuitive-statsd server to another statsd server.
FIP is used to tell the statsd agent what IP to forward to.
FPRT is used to tell the statsd agent what IP to forward to. (8125 by default)

More detail can be found in the Netuitive documentation.

Docker Pull Command
Owner
netuitive

Comments (1)
jeffkimble
12 days ago

found a small 'bug' in the USE_LOCAL_CONFIG. in the entrypoint.sh it defaults to checking [[ ! -n false ]] if you set the value to false. It will match ANY string in -e USE_LOCAL_DATA, not just 'true'