Jaeger Installation Guide

# Download Jaeger all-in-one binary
JAEGER_VERSION="1.51.0"
cd /tmp
wget https://github.com/jaegertracing/jaeger/releases/download/v${JAEGER_VERSION}/jaeger-${JAEGER_VERSION}-linux-amd64.tar.gz
tar -xzf jaeger-${JAEGER_VERSION}-linux-amd64.tar.gz

# Install Jaeger
sudo cp jaeger-${JAEGER_VERSION}-linux-amd64/jaeger-all-in-one /usr/local/bin/
sudo chmod +x /usr/local/bin/jaeger-all-in-one

# Create jaeger user
sudo useradd --system --shell /bin/false jaeger
sudo mkdir -p /var/lib/jaeger /var/log/jaeger
sudo chown -R jaeger:jaeger /var/lib/jaeger /var/log/jaeger

# Create systemd service
sudo tee /etc/systemd/system/jaeger.service > /dev/null <<EOF
[Unit]
Description=Jaeger Distributed Tracing
After=network.target

[Service]
Type=simple
User=jaeger
Group=jaeger
ExecStart=/usr/local/bin/jaeger-all-in-one \
  --memory.max-traces=10000 \
  --log-level=info
Restart=always
RestartSec=5s

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable --now jaeger

# Access UI at http://localhost:16686

# Create Jaeger stack with Elasticsearch
mkdir -p ~/jaeger

cat > ~/jaeger/docker-compose.yml <<EOF
version: '3.8'

services:
  elasticsearch:
    image: elasticsearch:7.17.15
    container_name: jaeger-elasticsearch
    restart: unless-stopped
    environment:
      - discovery.type=single-node
      - ES_JAVA_OPTS=-Xms2g -Xmx2g
    volumes:
      - elasticsearch_data:/usr/share/elasticsearch/data
    ports:
      - "127.0.0.1:9200:9200"
    networks:
      - jaeger

  jaeger-collector:
    image: jaegertracing/jaeger-collector:latest
    container_name: jaeger-collector
    restart: unless-stopped
    environment:
      - SPAN_STORAGE_TYPE=elasticsearch
      - ES_SERVER_URLS=http://elasticsearch:9200
      - ES_NUM_SHARDS=1
      - ES_NUM_REPLICAS=0
    ports:
      - "14268:14268"
      - "14250:14250"
    depends_on:
      - elasticsearch
    networks:
      - jaeger

  jaeger-agent:
    image: jaegertracing/jaeger-agent:latest
    container_name: jaeger-agent
    restart: unless-stopped
    environment:
      - REPORTER_GRPC_HOST_PORT=jaeger-collector:14250
    ports:
      - "6831:6831/udp"
      - "6832:6832/udp"
      - "5778:5778"
    depends_on:
      - jaeger-collector
    networks:
      - jaeger

  jaeger-query:
    image: jaegertracing/jaeger-query:latest
    container_name: jaeger-query
    restart: unless-stopped
    environment:
      - SPAN_STORAGE_TYPE=elasticsearch
      - ES_SERVER_URLS=http://elasticsearch:9200
    ports:
      - "127.0.0.1:16686:16686"
    depends_on:
      - elasticsearch
    networks:
      - jaeger

networks:
  jaeger:
    driver: bridge

volumes:
  elasticsearch_data:
EOF

docker-compose up -d

# Install Jaeger Operator
kubectl create namespace observability
kubectl create -n observability -f https://github.com/jaegertracing/jaeger-operator/releases/download/v1.50.0/jaeger-operator.yaml

# Deploy Jaeger instance
cat > jaeger-instance.yaml <<EOF
apiVersion: jaegertracing.io/v1
kind: Jaeger
metadata:
  name: jaeger
  namespace: observability
spec:
  strategy: production
  storage:
    type: elasticsearch
    options:
      es:
        server-urls: http://elasticsearch:9200
        num-shards: 1
        num-replicas: 0
  ingress:
    enabled: true
    annotations:
      kubernetes.io/ingress.class: nginx
    hosts:
      - jaeger.example.com
EOF

kubectl apply -f jaeger-instance.yaml

# Example: Instrument Node.js application
npm install --save jaeger-client opentracing

# Create tracing configuration
cat > tracing.js <<EOF
const opentracing = require('opentracing');
const jaeger = require('jaeger-client');

// Jaeger configuration
const config = {
  serviceName: 'my-nodejs-app',
  reporter: {
    agentHost: 'localhost',
    agentPort: 6832,
  },
  sampler: {
    type: 'probabilistic',
    param: 1.0, // Sample 100% of traces
  },
};

const options = {
  logger: {
    info: msg => console.log('JAEGER INFO:', msg),
    error: msg => console.error('JAEGER ERROR:', msg),
  },
};

const tracer = jaeger.initTracer(config, options);
opentracing.setGlobalTracer(tracer);

module.exports = tracer;
EOF