Docker 컨테이너 로그에서 알림 받기 - LoggiFly

 

안녕하세요. 달소입니다.

 

이전에 Docker 알람을 보내는 프로젝트를 소개시켜드렸는데 비슷한 프로젝트가 또 있네요.

요친구는 CLI에서 설정을해야하는점이 차이이긴 하지만 좀 성능적인 부분은 조금 더 낫지않을까 싶네요

 

관심있으신분들은 한번 설치해보시면 될것같습니다.

 

GitHub - clemcer/loggifly: Get Alerts from your Docker Container Logs Get Alerts from your Docker Container Logs. Contribute to clemcer/loggifly development by creating an account on GitHub. from GITHUB

 

LoggiFly란 무엇인가요?

LoggiFly는 컨테이너 로그를 모니터링하고 특정 키워드나 패턴이 나타나면 알림을 보내는 작은 오픈소스 도구입니다. 전체 로깅 스택을 설정하지 않고도 충돌, 오류 등 중요한 문제를 조기에 포착할 수 있도록 도와줍니다. 또한, LoggiFly는 알림 기능이 제대로 지원되지 않는 앱에서도 알림을 받을 수 있습니다.

 

image.png

 

LoggiFly는 매우 가벼운 컨테이너로 실행되며 Docker(또는 Podman) 소켓에 직접 연결됩니다. ntfy 또는 Apprise를 통해 대부분의 다른 알림 서비스(Discord, Slack, Telegram 등)에 알림을 보낼 수 있습니다. LoggiFly는 컨테이너를 자동으로 재시작하고, 알림에 로그 파일을 첨부하고, 관련 정보만 추출하여 메시지 형식을 지정하는 등 다양한 기능을 제공합니다.

환경 변수를 통한 간단한 설정과 config.yaml 파일을 통한 고급 구성을 모두 지원하므로 컨테이너별, 심지어 키워드별로 알림을 완벽하게 제어할 수 있습니다.

LoggiFly는 배포가 쉽고 유연하며, 추가적인 복잡성 없이 컨테이너를 모니터링하고자 하는 사람들을 위해 만들어졌습니다.

이상적인 대상 :

  • ✅ 보안 침해 발견(예: Vaultwarden에서 로그인 실패)
  • ✅ 첨부된 로그 컨텍스트를 사용하여 충돌 디버깅
  • ✅ 특정 오류 발생 시 컨테이너를 다시 시작하거나 완전히 중지하여 재시작 루프를 방지합니다.
  • ✅ 사용자 지정 앱 동작 모니터링(예: 로그인 실패 또는 사용자가 Audiobookshelf 서버에서 오디오북을 다운로드할 때)

 

image.png

 

구성 구조

이 config.yaml파일은 4개의 주요 섹션으로 나뉩니다.

  1. settings: 전체 프로그램에 대한 글로벌 설정( 모두 기본값을 가지고 있으므로 선택 사항 )
  2. notifications: Ntfy( URL, 주제, 토큰, 우선순위 및 태그 ), Apprise URL 및/또는 사용자 정의 웹훅 URL
  3. containers: 모니터링할 컨테이너와 해당 키워드를 정의합니다( 선택적 설정 포함 ).
  4. global_keywords : 모니터링되는 모든 컨테이너 에 적용되는 키워드입니다 .

 

What is LoggiFly? | LoggiFly LoggiFly Documentation from CLEMCER.GITHUB.IO

 

Config Structure | LoggiFly LoggiFly Documentation from CLEMCER.GITHUB.IO

 

원격호스트도 지원하네요.

Remote Hosts | LoggiFly LoggiFly Documentation from CLEMCER.GITHUB.IO