Skip to content

Latest commit

 

History

History
65 lines (58 loc) · 3.18 KB

eks-demo.md

File metadata and controls

65 lines (58 loc) · 3.18 KB
Raw

Using AWS-Observability-Collector on Amazon EKS

This example will introduce how to use AWS-Observability-Collector to send application traces and metrics on AWS EKS. This instruction provided the data emitter image that will generate OTLP format of metrics and traces data to AWS CloudWatch and X-Ray consoles. Please follow the steps below to try AWS Observability Collector Beta.

Create EKS-AWSObservability IAM Policy

  1. Open the IAM console at https://console.aws.amazon.com/iam/.
  2. In the navigation pane, choose Policies.
  3. Choose Create policy, JSON.
  4. Enter the following policy:
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "logs:CreateLogGroup",
                "logs:CreateLogStream",
                "logs:PutLogEvents",
                "logs:DescribeLogStreams",
                "xray:*",
                "s3:*"
            ],
            "Resource": [
                "arn:aws:logs:*:*:*"
            ]
        }
    ]
}
  1. Choose Review policy.
  2. On the Review policy page, enter EKS-AWSObservability for the Name and choose Create policy.

Attach EKS-AWSObservability IAM Role to worker ndoes

  1. Open the Amazon EC2 console at https://console.aws.amazon.com/ec2/.
  2. Select one of the worker node instances and choose the IAM role in the description.
  3. On the IAM role page, choose Attach policies.
  4. In the list of policies, select the check box next to EKS-AWSObservability. If necessary, use the search box to find this policy.
  5. Choose Attach policies.

Deploy AOC on Amazon EKS as sidecar

The easiest way to deploy AOC on Amazon EKS is to run it as a sidecar, defining it in the same task definition as your application.

  1. Create a Kubernetes namespace.
kubectl create namespace aoc-eks
  1. An example config template can be found here. Replace {{aocImage}} with the name of the AOC Docker image you built (e.g. ghcr.io/mxiamxia/aws-observability-collector:v0.1.11), and {{region}} with the name of the region where the logs are published (e.g. us-west-2).
  2. Deploy the application.
kubectl apply -f examples/eks/eks-sidecar.yaml
  1. View the resources in the aoc-eks namespace.
kubectl get all -n aoc-eks
  1. View the details of the deployed deployment.
kubectl -n aoc-eks describe deployment aoc-eks-sidecar

The example template provided runs the AWS-Observability-Collector as sidecar to send application metrics and traces on Amazon EKS. We run two applications: the customer’s application (aoc-emitter) and the AOC aoc-collector. Running the AOC in the same application as the main application allows the AOC to collect the metric/trace data for the customer’s application. We also call running the AOC in this way a "Sidecar".

View Your Metrics
You should now be able to view your metrics in your CloudWatch console. In the navigation bar, click on Metrics. The collected AOC metrics can be found in the AWSObservability/CloudWatchOTService namespace. Ensure that your region is set to the region set for your cluster.