Set up Grafana Enterprise LogsDeploy on Linux

Deploy on linux

Prerequisites

You will need:

  • A DNS name that resolves to all nodes of the Enterprise Logs cluster. This guide uses enterprise-logs.local in the following examples.
  • To configure the replication factor in the enterprise-logs.yaml configuration file. For a cluster of less than three nodes, lifecycler.ring.kvstore should be set to 1. Otherwise, the default value of 3 should be used.

Install Enterprise Logs

Run the following commands on every node as the root user:

# # Add dedicated user and group
# groupadd --system enterprise-logs
# useradd --system --home-dir /var/lib/enterprise-logs -g enterprise-logs enterprise-logs

# # Create directories
# mkdir -p /etc/enterprise-logs /var/lib/enterprise-logs
# chown root:enterprise-logs /etc/enterprise-logs
# chown enterprise-logs:enterprise-logs /var/lib/enterprise-logs
# chmod 0750 /etc/enterprise-logs /var/lib/enterprise-logs

# # Download enterprise-logs binary
# curl -Lo /usr/local/bin/enterprise-logs \
  https://storage.googleapis.com/grafana-enterprise-logs/releases/enterprise-logs-v1.0.0-linux-amd64
# echo "d123d211d40ebbf41af9d7e6c87030bacdc6b62e8490b872aef970a22bb44b04" \
 "/usr/local/bin/enterprise-logs" | sha256sum -c
# chmod 0755 /usr/local/bin/enterprise-logs
# setcap 'cap_net_bind_service=+ep' /usr/local/bin/enterprise-logs

# # Set up systemd unit and enable startup on boot
# cat > /etc/systemd/system/enterprise-logs.service <<EOF
[Unit]
After=network.target

[Service]
User=enterprise-logs
Group=enterprise-logs
WorkingDirectory=/var/lib/enterprise-logs
ExecStart=/usr/local/bin/enterprise-logs \
   -config.file=/etc/enterprise-logs/enterprise-logs.yaml \
   -log.level=warn \
   -memberlist.join=enterprise-logs.local:7946 \
   -querier.frontend-address=enterprise-logs.local:9095

[Install]
WantedBy=default.target
EOF
# systemctl daemon-reload
# systemctl enable enterprise-logs.service

Copy configuration and license

Copy the configuration and the license files to all nodes in the Enterprise Logs cluster:

  • enterprise-logs.yaml should be copied to /etc/enterprise-logs/enterprise-logs.yaml
  • license.jwt should be copied to /etc/enterprise-logs/license.jwt

Generate an admin token

Generate an admin token by running the following on a single node in the cluster:

# su enterprise-logs -c "/usr/local/bin/enterprise-logs \
   --config.file=/etc/enterprise-logs/enterprise-logs.yaml \
   --bootstrap.license.path=/etc/enterprise-logs/license.jwt \
   --log.level=warn \
   --target=tokengen
Token created:  YWRtaW4tcG9saWN5LWJvb3RzdHJhcC10b2tlbjo8Ujc1IzQyfXBfMjd7fDIwMDRdYVxgeXw=

Start all Enterprise Logs replicas

Start the enterprise-logs service on each node:

# systemctl start enterprise-logs.service

Next: Set up an instance.