Overview

This repo contains a small python service using flask. The service is available in 4 stages.

1 - without any instrumentation

2 - with basic Elastic APM instrumentation

3 - with a more advanced Elastic APM instrumentation

4 - with custom spans

5 - with custom context

6 - with ECS logging

7 - calling second service, showing distributed tracing

8 - calling third service, showing distributed tracing

11 - instrumented with OTEL instead of Elastic APM

Requirements

Redis is required for the services to run.

docker run -p 6379:6379 -d redis

A Python venv is recommended:

virtualenv -p python3 .venv
source .venv/bin/activate

Install dependencies:

pip install -r requirements.txt

Before running the services, make sure you provide the following endpoints and credentials:

.env: 

SECRET_TOKEN
SERVER_URL
OTEL_EXPORTER_OTLP_ENDPOINT
OTEL_EXPORTER_OTLP_HEADERS


filebeat.yml:
 
cloud.id: deploymentname:secret123
cloud.auth: elastic:secret123
or 
output.elasticsearch:
  hosts: ["localhost:9200"]
  username: "elastic"
  password: "changeme"

You can download Filebeat here: https://www.elastic.co/downloads/beats/filebeat

APM-Server, Elasticsearch and Kibana also need to be running. You can find more information about the Elastic Stack here

Running the Python Services and loadgen:

To run the python services, execute the following command for the file you'd like to run:

sh loadgen.sh

Screenshots of Kibana