openeuler/telegraf repository overview

⁠Quick reference

• The official Telegraf docker image.

• Maintained by: openEuler CloudNative SIG⁠.

• Where to get help: openEuler CloudNative SIG⁠, openEuler⁠.

⁠Telegraf | openEuler

Current Telegraf docker images are built on the openEuler⁠. This repository is free to use and exempted from per-user rate limits.

Telegraf, a server-based agent, collects and sends metrics and events from databases, systems, and IoT sensors. Written in Go, Telegraf compiles into a single binary with no external dependencies–requiring very minimal memory.

Learn more on Telegraf website⁠.

⁠Supported tags and respective Dockerfile links

The tag of each telegraf docker image is consist of the version of telegraf and the version of basic image. The details are as follows

⁠Usage

In this usage, users can select the corresponding {Tag} and container startup options based on their requirements.

• Pull the openeuler/telegraf image from docker

  docker pull openeuler/telegraf:{Tag}
  

  Copy

• Start a telegraf instance

  docker run -d --name my-telegraf -p 8094:8094 -v /path/to/telegraf.conf:/etc/telegraf/telegraf.conf openeuler/telegraf:{Tag}
  

  Copy

  After the instance my-telegraf is started, access the Telegraf service through http://localhost:8094.

• Container startup options

  Option	Description
  -p 8094:8094	Expose telegraf on localhost:8094.
  -v /path/to/telegraf.conf:/etc/telegraf/telegraf.conf	Local configuration file⁠⁠ telegraf.conf.

• View container running logs

  docker logs -f my-telegraf
  

  Copy

• To get an interactive shell

  docker exec -it my-telegraf /bin/bash
  

  Copy

⁠Question and answering

If you have any questions or want to use some special features, please submit an issue or a pull request on openeuler-docker-images⁠.