Docker 컨테이너 로그에서 알림 받기 - LoggiFly
안녕하세요. 달소입니다.
이전에 Docker 알람을 보내는 프로젝트를 소개시켜드렸는데 비슷한 프로젝트가 또 있네요.
요친구는 CLI에서 설정을해야하는점이 차이이긴 하지만 좀 성능적인 부분은 조금 더 낫지않을까 싶네요
관심있으신분들은 한번 설치해보시면 될것같습니다.
LoggiFly란 무엇인가요?
LoggiFly는 컨테이너 로그를 모니터링하고 특정 키워드나 패턴이 나타나면 알림을 보내는 작은 오픈소스 도구입니다. 전체 로깅 스택을 설정하지 않고도 충돌, 오류 등 중요한 문제를 조기에 포착할 수 있도록 도와줍니다. 또한, LoggiFly는 알림 기능이 제대로 지원되지 않는 앱에서도 알림을 받을 수 있습니다.

LoggiFly는 매우 가벼운 컨테이너로 실행되며 Docker(또는 Podman) 소켓에 직접 연결됩니다. ntfy 또는 Apprise를 통해 대부분의 다른 알림 서비스(Discord, Slack, Telegram 등)에 알림을 보낼 수 있습니다. LoggiFly는 컨테이너를 자동으로 재시작하고, 알림에 로그 파일을 첨부하고, 관련 정보만 추출하여 메시지 형식을 지정하는 등 다양한 기능을 제공합니다.
환경 변수를 통한 간단한 설정과 config.yaml 파일을 통한 고급 구성을 모두 지원하므로 컨테이너별, 심지어 키워드별로 알림을 완벽하게 제어할 수 있습니다.
LoggiFly는 배포가 쉽고 유연하며, 추가적인 복잡성 없이 컨테이너를 모니터링하고자 하는 사람들을 위해 만들어졌습니다.
이상적인 대상 :
- ✅ 보안 침해 발견(예: Vaultwarden에서 로그인 실패)
- ✅ 첨부된 로그 컨텍스트를 사용하여 충돌 디버깅
- ✅ 특정 오류 발생 시 컨테이너를 다시 시작하거나 완전히 중지하여 재시작 루프를 방지합니다.
- ✅ 사용자 지정 앱 동작 모니터링(예: 로그인 실패 또는 사용자가 Audiobookshelf 서버에서 오디오북을 다운로드할 때)

구성 구조
이 config.yaml파일은 4개의 주요 섹션으로 나뉩니다.
settings: 전체 프로그램에 대한 글로벌 설정( 모두 기본값을 가지고 있으므로 선택 사항 )notifications: Ntfy( URL, 주제, 토큰, 우선순위 및 태그 ), Apprise URL 및/또는 사용자 정의 웹훅 URLcontainers: 모니터링할 컨테이너와 해당 키워드를 정의합니다( 선택적 설정 포함 ).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