BDOT Collector Architecture

Both Fargate and EC2 deployment options include:

• VPC with Public Subnets - Network isolation with internet access
• Security Groups - Controlled access to collector ports (4317 and 4318)
• CloudWatch Logging - Centralized logging and monitoring
• Auto Scaling - Automatic scaling based on demand

Key Features

Container Configuration

• BDOT Collector Image: ghcr.io/observiq/bindplane-agent
• OpAMP Protocol: Connects to Bindplane Server via OpAMP
• Automatic Configuration: Receives configurations from Bindplane Server
• Persistent Storage: Maintains manager.yaml configuration

Ports and Services

• 4317: OTLP gRPC receiver
• 4318: OTLP HTTP receiver

Environment Variables

• OPAMP_ENDPOINT: Bindplane Server OpAMP endpoint
• OPAMP_SECRET_KEY: Collector authentication key
• OPAMP_LABELS: Collector labels for identification

Prerequisites

Before deploying, ensure you have:

1. AWS CLI v2.x installed and configured
2. Valid AWS account with appropriate permissions
3. Bindplane Server running (self-hosted or cloud)
4. Collector secret key from your Bindplane Server

Getting Your Secret Key

1. Navigate to your Bindplane Server UI
2. Go to Collectors → Install Collector
3. Choose Linux platform
4. Copy the secret-key from the installation instructions

Configuration

OpAMP Endpoint URLs

• Bindplane Cloud: wss://app.bindplane.com/v1/opamp
• Self-hosted (HTTP): ws://your-server:3001/v1/opamp
• Self-hosted (HTTPS): wss://your-server:443/v1/opamp

Monitoring and Troubleshooting

CloudWatch Logs

# View collector logs
aws logs tail /ecs/collector --follow

Common Issues

1. Collector not appearing: Check OpAMP endpoint and secret key
2. Connection failures: Verify network connectivity and security groups
3. High resource usage: Scale up resources or add more instances

Scaling

Manual Scaling

# Update desired count
aws ecs update-service \
  --cluster your-cluster \
  --service collector-service \
  --desired-count 3

Auto Scaling

Both deployment options support Application Auto Scaling for automatic scaling based on CPU/memory utilization.