Skip to content
This repository has been archived by the owner on Nov 6, 2021. It is now read-only.

Code examples showing how to run AWS X-Ray on a Kubernetes cluster for deep application insights.

License

Notifications You must be signed in to change notification settings

aws-samples/aws-xray-kubernetes

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

33 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

aws-xray-kubernetes

Code examples showing how to run AWS X-Ray on a Kubernetes cluster for deep application insights. Please also see the acompanying blog post for background information.

Changelog

  • 04/05/2020 Clean up permissions for X-Ray daemon. Expose tcp and udp port.
  • 03/31/2020 Update deployment specs to latest k8s version. Use official AWS X-Ray Docker image.
  • 03/17/2020 Update sample app dependencies

Run AWS X-Ray on Kubernetes

The xray-daemon folder contains the code required to build and deploy an AWS X-Ray daemon Docker image and deploy this to an existing EKS or Kubernetes cluster.

Images have been built and pushed to Docker Hub for easier consumption of this project.

Deploying

Set up the correct permissions in AWS IAM so your pod can utilize. Utilize the EKS feature for IAM for Service Accounts. See the file xray-k8s-daemonset.yaml or EKS Userguide for setup instructions. Then run kubectl apply -f xray-k8s-daemonset.yaml to install the AWS X-Ray daemons on your Kubernetes cluster.

Fallback option is to attache the IAM policy named arn:aws:iam::aws:policy/AWSXRayDaemonWriteAccess to the worker nodes in your cluster.

Demo apps

Two simple demo applications are provided to showcase how AWS X-Ray enables deep application insights into a microservices architecture.

Simply run kubectl apply -f k8s-deploy.yml to install both services. Look up the endpoint for service-a and send a couple of requests against this endpoint. Switch to the AWS X-Ray console and see how the traces are showing up in the console.

License

This project is licensed under the Apache 2.0 License.

About

Code examples showing how to run AWS X-Ray on a Kubernetes cluster for deep application insights.

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published