The LogDNA Agent is a log collection tool written in JavaScript that streams log files from Linux, Windows, and macOS servers to LogDNA's centralized logging platform. The agent authenticates using a LogDNA Ingestion Key and establishes a secure WebSocket connection to LogDNA's ingestion servers, where it continuously monitors specified directories for new log data and newly created files. The repository is classified across multiple observability and monitoring domains including log collection, syslog support, application logging, infrastructure observability, centralized logging, real-time logging, and security monitoring.
The agent's core functionality includes maintaining persistent HTTPS-encrypted connections to LogDNA servers with automatic reconnection and queuing of log lines during disconnections. It compresses logs using gzip before upload and rescans all configured log directories every minute for new files. The agent supports multiple log rotation methods including renamed files, truncated files, and the "new file per day" rotation pattern across most operating systems. Configuration is handled through a config file located at /etc/logdna.conf on Linux and C:\ProgramData\logdna\logdna.conf on Windows, with options to specify log directories using glob patterns, exclude specific files or patterns, filter log lines with regex, set tags for data organization, and override the system hostname.
The repository includes specialized support for containerized and orchestrated environments. It provides documentation and configuration for Kubernetes logging, allowing the agent to extract metadata such as pod names, container names, namespaces, and labels. OpenShift logging is also supported with a DaemonSet deployment that automatically installs an agent pod on each cluster node to collect both application and node logs, with testing confirmed on OpenShift versions 3.5 through 11. For Fedora CoreOS and other docker-less containerized systems using journald, the agent can be run inside a container with systemd to read from journalctl and forward logs appropriately.
Windows logging is supported through Chocolatey installation and requires Windows PowerShell v3 or higher, Windows 7 or later, and .NET Framework 4.x or higher. The agent can be installed from official releases or built from source, with command-line tools available for setting ingestion keys and adding directories to monitor.
According to GitGenius activity tracking, the repository shows a median and mean issue and pull request response latency of 2.5 hours across tracked items, indicating active maintenance. The most active contributors tracked include c-nixon with 3 events and kreeksec with 1 event. The repository shares overlapping contributors with major projects including microsoft/vscode, microsoft/typescript, and rust-lang/rust, suggesting involvement from developers working across multiple significant open-source ecosystems.
A deprecation warning in the repository indicates that logdna-agent will soon cease support, with users directed to LogDNA Agent V2 for future implementations. The agent supports LogDNA's pay-per-gig pricing model starting at $1.50 per gigabyte per month with no fixed data buckets, and all paid plans include full feature access.
