Configure the LogFlux Agent

1

sudo nano /etc/logflux-agent/agent.yaml

1
2

agent:
    api_key: eu-lf_your-api-key-here

1

sudo systemctl enable --now logflux-agent

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68

# Basic agent settings
agent:
    api_key: "eu-lf_your-api-key-here"     # REQUIRED
    # hostname: ""                           # Override auto-detected hostname
    # server_url: ""                         # Override auto-discovered ingestor URL
    # log_level: "info"                      # debug, info, warn, error, fatal
    # public_key_fingerprint: ""             # RSA fingerprint for MITM protection
    # fingerprint_mode: "warn"               # warn or strict

# Proxy (for connecting to backend through HTTP proxy)
proxy:
    # enabled: false
    # url: ""                                # http://proxy:8080 or socks5://proxy:1080
    # username: ""
    # password: ""

# Queue (durable SQLite queue for log entries)
queue:
    # type: "sqlite"
    # size: 10000                            # Max entries in queue
    # max_memory_usage: 104857600            # 100 MB
    # database_path: "/var/lib/logflux-agent/queue.db"

# Batch processing (controls how entries are sent to the ingestor)
batch:
    size: 500                                # Entries per batch (immediate flush when full)
    # flush_interval: 5s                     # Max time before flushing partial batch
    # max_batch_wait: 30s                    # Safety limit for batch accumulation
    # compression_type: "gzip"               # gzip or zstd
    # max_batch_retries: 3

# Retry (exponential backoff for failed sends)
retry:
    # max_retries: 10
    # initial_delay: 100ms
    # max_delay: 60s
    # backoff_factor: 2.0
    # resilient_mode: true                   # Queue entries on persistent failure

# Workers
workers:
    # count: 4                               # Concurrent send workers

# Health check
health:
    # check_interval: 30s

# Graceful shutdown
# shutdown_timeout: 30s

# Local server (Unix socket for plugin communication)
local_server:
    unix:
        # path: "/var/run/logflux-agent/agent.sock"
    protocol:
        # max_message_size: 1048576          # 1 MB
        # max_connections: 100
        ping_interval: 20s                   # Keepalive ping (0 to disable)
    buffer:
        # size: 4096
        # max_batch_size: 100
        # flush_interval: 5s

# Tags (added to all log entries as metadata)
tags:
    # environment: "production"
    # region: "us-west-2"
    # datacenter: "dc1"

1
2
3

tags:
    environment: "production"   # metadata["tag_environment"] = "production"
    region: "us-west-2"         # metadata["tag_region"] = "us-west-2"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

name: plugin-name
version: 1.0.0
source: plugin-source

agent:
    socket_path: /var/run/logflux-agent/agent.sock
    network: unix
    connect_timeout: 10s
    max_retries: 3
    retry_delay: 1s

plugin:
    # Plugin-specific settings (see integration docs)

logging:
    level: info
    labels: {}
    verbose: false

batch:
    enabled: true
    max_size: 100
    flush_interval: 5s
    auto_flush: true

1
2
3
4
5

sudo chmod 600 /etc/logflux-agent/agent.yaml
sudo chown root:logflux /etc/logflux-agent/agent.yaml

sudo chmod 700 /etc/logflux-agent/plugins/
sudo chown -R root:logflux /etc/logflux-agent/plugins/

1

sudo systemctl edit logflux-agent

1
2

[Service]
Environment=LOGFLUX_API_KEY=eu-lf_abcd1234efgh5678ijkl9012mnop3456

1
2
3
4
5

sudo systemctl start logflux-agent
sudo systemctl stop logflux-agent
sudo systemctl restart logflux-agent
sudo systemctl status logflux-agent
sudo journalctl -u logflux-agent -f

1
2
3
4
5
6
7

# Enable plugins
sudo systemctl enable --now logflux-agent-journald
sudo systemctl enable --now logflux-agent-metrics

# Disable unused plugins
sudo systemctl disable logflux-agent-docker
sudo systemctl disable logflux-agent-kubernetes