Skip to content

Latest commit

 

History

History
42 lines (30 loc) · 2 KB

README.MD

File metadata and controls

42 lines (30 loc) · 2 KB
Raw

Fluentd Docker Image for New Relic Logs

newrelic-fluentd-docker is a custom Docker image that runs Fluentd, listens for log events from containers running the Fluentd logging driver, and forwards them to New Relic. The image can be customized to support additional use cases (e.g. tailing files on a container host, receiving and forwarding syslog input).

Usage

Default Fluentd Configuration

The command below configures the container to receive and forward log events from other Docker containers running the Fluentd logging driver:

docker run --name="newrelic-fluentd-docker" --restart=always -d -p 24224:24224 \
-e "API_KEY=<YOUR API INSERT KEY>" -e "BASE_URI=<YOUR HTTP ENDPOINT>" \ 
-e "LOG_LEVEL=<YOUR DEFAULT LOG LEVEL>" newrelic/newrelic-fluentd-docker:latest

Custom Fluentd Configuration

  1. Clone this repository:
  $ git clone https://github.com/newrelic/newrelic-fluentd-docker
  1. Replace the default fluent.conf with your custom Fluentd configuration.
  2. Build your custom Fluentd image:
docker build . -t newrelic-fluentd-docker

Configuration

Environment Variables

Property Description Default Value Required or Optional
API_KEY Your New Relic API insert key - Required
BASE_URI New Relic ingestion endpoint https://log-api.newrelic.com/log/v1 Optional
LOG_LEVEL Fluentd log level warn Optional

Getting Your Keys

  • You can retrieve your New Relic Insights insert key from the following location: https://insights.newrelic.com/accounts/<YOUR ACCOUNT ID>/manage/api_keys