Name: LogDNA Agent for Windows
SKU: -

소개

LogDNA Agent for Windows는 로그 파일을 LogDNA 계정으로 스트리밍하는 오픈소스 에이전트입니다. LogDNA에서 개발 및 유지보수하며, Windows, Linux, macOS 서버에서 작동합니다. 로그 파일을 실시간으로 수집하여 LogDNA 플랫폼으로 전송하여 중앙집중식 로그 관리를 가능하게 합니다.

상세정보

로그 스트리밍 및 처리

에이전트는 로그 파일의 새로운 데이터를 지속적으로 추적(tail)하고, LogDNA 수집 서버와의 지속적인 HTTPS 연결을 유지합니다. 연결이 끊어졌을 경우 자동으로 재연결하며, 연결이 끊어진 동안 새로운 로그 라인을 큐에 저장하여 전송합니다.

파일 모니터링 및 로테이션 처리

에이전트는 지정된 로그 디렉터리에서 새로운 파일을 매 분마다 재스캔합니다. 대부분의 운영 체제에서 로그 로테이션을 지원하며, 이름 변경, 트렁케이트, 그리고 ‘하루당 새 파일’ 방식의 로그 로테이션 방법을 처리할 수 있습니다.

데이터 압축 및 보안

업로드 전에 로그 데이터를 gzip으로 압축하여 전송 효율성을 높입니다. LogDNA 인증 키를 사용하여 보안 웹 소켓을 통해 데이터를 전송하며, 모든 통신은 HTTPS로 암호화됩니다.

다운로드·설치 방법

Chocolatey를 통해 LogDNA Agent를 설치할 수 있습니다. 공식 Chocolatey 패키지 이름은 chocolatey.logdna-agent이며, 설치 명령어는 다음과 같습니다:

choco install logdna-agent

설치 후, 에이전트를 실행하기 위해서는 LogDNA 계정에서 발급받은 Ingestion Key가 필요합니다. 키를 설정하는 방법은 다음과 같습니다:

sudo node index.js -k

이 명령을 실행하면 Windows에서는 C:ProgramDatalogdnalogdna.conf 경로에 설정 파일이 자동으로 생성됩니다.

기본 사용법/명령어

에이전트를 소스에서 실행하려면 다음 단계를 따릅니다:

저장소를 클론합니다: git clone https://github.com/logdna/logdna-agent.git
디렉터리로 이동합니다: cd logdna-agent
의존성을 설치합니다: npm install
도움말을 확인합니다: sudo node index.js --help
로그 디렉터리를 지정하여 에이전트를 시작합니다 (예: 기본 Windows 로그 디렉터리 사용): sudo node index.js -d "C:ProgramDatalogs" -k

설정 파일(C:ProgramDatalogdnalogdna.conf)을 직접 생성하여 사용할 수도 있습니다. 예시:

logdir = C:\Users\username\AppData\myapp
key =

이런 경우에 유용합니다

Windows 서버에서 애플리케이션 및 시스템 로그를 중앙집중식으로 관리해야 하는 시스템 관리자 및 DevOps 엔지니어에게 유용합니다. 여러 서버의 로그를 하나의 LogDNA 계정으로 통합하여 실시간 모니터링, 문제 해결, 그리고 compliance auditing을 효율적으로 수행할 수 있습니다.

지원 환경·시스템 요구사항

에이전트는 Windows 7 이상 및 Windows Server 2003 이상에서 실행됩니다. Windows PowerShell v3+가 필요하며, .NET Framework 4.x+가 설치되어 있어야 합니다. Windows Nano Server 및 PowerShell Core(PowerShell 6)는 지원되지 않습니다.

제한 사항·확인 사항

LogDNA Agent는 곧 지원 종료(deprecation)될 예정이며, 향후 모든 구현은 LogDNA Agent V2()를 참조해야 합니다. 현재 버전은 여전히 작동하지만, 새로운 기능 추가 및 보안 업데이트는 제공되지 않을 수 있습니다.

FAQ

LogDNA Agent는 무료인가요?
네, LogDNA Agent는 MIT 라이선스로 배포되는 오픈소스 소프트웨어입니다. 그러나 로그 데이터를 전송할 대상인 LogDNA 서비스는 유료 플랜이 있으며, 무료 티어도 제공됩니다.
Windows에서 Chocolatey 없이 설치할 수 있나요?
네, 소스 코드를 클론하여 npm을 통해 직접 설치하고 실행할 수 있습니다. 공식 웹사이트에서 제공하는 설치 가이드를 따를 수 있습니다.

시스템 요구사항

별도의 시스템 요구사항이 등록되지 않았습니다.

LogDNA Agent for Windows

소개