laws-africa / elk-docker

ELK and APM configuration for Laws.Africa

Laws.Africa Metrics Processing Stack

Configuration files for Laws.Africa ELK stack, using Elasticsearch (E), Logstash (L), Kibana (K) and Elastic APM. Adapted from https://github.com/elastic/stack-docker. An overview of the APM setup is available at https://www.elastic.co/guide/en/apm/get-started/current/overview.html

This sets up a collection of services to process metrics and display them in a Kibana dashboard.

This instance is not accessible from the outside world. Access to Kibana is through a secure nginx proxy.

Networking

This runs:

• Elasticsearch, listening on :9200
• APM server, listening on :8200
• Kibana, listening on :5601

The DNS entry elk.int.laws.africa should be set to the AWS-internal IP address of this instance.

AWS firewalls prevent any of these from being accessed from outside the network.

Installation

Install docker-compose:

1. sudo curl -L "https://github.com/docker/compose/releases/download/1.23.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
2. sudo chmod +x /usr/local/bin/docker-compose

Install this package:

1. git clone https://github.com/laws-africa/elk-docker.git
2. cd elk-docker
3. docker-compose up -d