개요
Telegraf는 플러그인 기반의 서버 사이드 에이전트로, 데이터베이스, 시스템 및 IoT 센서로부터 메트릭과 이벤트를 수집하여 전송합니다. 300개 이상의 입력, 출력 및 집계 플러그인을 지원하며, 외부 종속성이 없는 정적 바이너리로 컴파일됩니다.
README 미리보기
# Telegraf\n\n[](https://godoc.org/github.com/influxdata/telegraf)\n[](https://hub.docker.com/_/telegraf/)\n[](https://goreportcard.com/report/github.com/influxdata/telegraf)\n[](https://circleci.com/gh/influxdata/telegraf)\n\nTelegraf is an agent for collecting, processing, aggregating, and writing\nmetrics, logs, and other arbitrary data.\n\n* Offers a comprehensive suite of over 300 plugins, covering a wide range of\n functionalities including system monitoring, cloud services, and message\n passing\n* Enables the integration of user-defined code to collect, transform, and\n transmit data efficiently\n* Compiles into a standalone static binary without any external dependencies,\n ensuring a streamlined deployment process\n* Utilizes TOML for configuration, providing a user-friendly and unambiguous\n setup experience\n* Developed with contributions from a diverse community of over 1,200\n contributors\n\nUsers can choose plugins from a wide range of topics, including but not limited\nto:\n\n* Devices: [OPC UA][], [Modbus][]\n* Logs: [File][], [Tail][], [Directory Monitor][]\n* Messaging: [AMQP][], [Kafka][], [MQTT][]\n* Monitoring: [OpenTelemetry][], [Prometheus][]\n* Networking: [Cisco TelemetryMDT][], [gNMI][]\n* System monitoring: [CPU][], [Memory][], [Disk][], [Network][], [SMART][],\n [Docker][], [Nvidia SMI][], etc.\n* Universal: [Exec][], [HTTP][], [HTTP Listener][], [SNMP][], [SQL][]\n* Windows: [Event Log][], [Management Instrumentation][],\n [Performance Counters][]\n\n## 🔨 Installation\n\nFor binary builds, Docker images, RPM & DEB packages, and other builds of\nTelegraf, please see the [install guide](/docs/INSTALL_GUIDE.md).\n\nSee the [releases documentation](/docs/RELEASES.md) for details on versioning\nand when releases are made.\n\n## 💻 Usage\n\nUsers define a TOML configuration with the plugins and settings they wish to\nuse, then pass that configuration to Telegraf. The Telegraf agent then\ncollects data from inputs at each interval a
FAQ (4)
문제 해결1150개 이상의 노드를 모니터링할 때 Telegraf OPC UA 리스너 'EOF' 오류를 해결하는 방법
이는 알려진 버그(issue #14568)로, OPC UA listener 플러그인이 보안 연결이 구성된 많은 노드에 대해 너무 큰 요청을 보냅니다. 서버는 'BadTcpMessageTooLarge'로 이를 거부하여 'EOF' 오류를 발생시킵니다. 해결 방법: 노드를 약 500개씩 그룹으로 나누어 여러 [[inputs.opcua_listener]] 인스턴스 또는 group 블록에 분산하십시오. 영구적인 배치 수정이 개발 중입니다.
문제 해결왜 Telegraf 시스템 업타임 메트릭이 Prometheus에서 게이지 유형으로 보고되나요?
Telegraf(출시되지 않은 1.39.0)의 버그로 인해 'uptime' 메트릭이 게이지로 잘못 등록되었습니다. 올바른 유형은 카운터이며, uptime은 증가만 하기 때문입니다. 이 문제는 릴리스 전에 수정될 예정입니다. 영향을 받는 개발 빌드의 경우, Prometheus에서 metric_relabel_configs 또는 relabeling 규칙을 사용하여 메트릭 유형을 카운터로 재정의하는 방법으로 해결할 수 있습니다. 수정이 완료되면 최신 안정 버전으로 업그레이드하세요.
문제 해결Telegraf docker_log 입력이 statefile이 설정되어 있음에도 재시작 후 이전 로그를 다시 전송하는 이유는 무엇인가요?
상태 파일은 정상 종료 시에만 기록됩니다. docker compose down이나 docker compose up -d를 사용하면 상태가 저장되기 전에 컨테이너가 종료될 수 있습니다. 해결 방법: 먼저 docker compose stop으로 Telegraf를 정상적으로 중단한 후 docker compose down 또는 docker compose up -d를 실행하세요. 종료 로그에 "Persisting plugin states"가 표시되는지 확인하십시오. 또한 stop_grace_period: 30s와 같은 중지 제한 시간을 늘려 Telegraf가 데이터를 플러시하고 저장할 시간을 확보할 수 있습니다.
문제 해결왜 Telegraf disk plugin이 read-only mounted filesystem에 대해 mode=rw로 보고합니까?
이것은 gopsutil (disk_linux.go)에서 /proc/mounts 대신 /etc/mtab에 의존하는 알려진 버그입니다. Telegraf ≥1.14.0에서 수정되었습니다. 최신 Telegraf로 업그레이드하거나 다음 해결 방법을 적용하십시오: 파일 시스템이 /proc/mounts에서 명시적으로 'ro' 태그가 지정되고 ignore_fs에 의해 제외되지 않았는지 확인하십시오.