aws-samples/aws-xray-kubernetes

Name: aws-xray-kubernetes

Owner: AWS Samples

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

Created: 2018-01-18 21:39:45.0

Updated: 2018-03-14 22:39:43.0

Pushed: 2018-03-19 01:07:31.0

Homepage: null

Size: 24

Language: JavaScript

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

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.

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.

Utilize the buildspec.yml for AWS CodeBuild to build and push the Docker image to an ECR repository.

Deploying

Set up the correct URI pointing to your ECR repository where the X-Ray image is stored in the xray-k8s-daemonset.yml file. Then run `kubectl apply -f xray-k8s-daemonset.yaml` to install the AWS X-Ray daemons on your Kubernetes cluster.

Demo apps

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

To install and run both services build both container images and upload them to ECR repositories. Edit the `k8s-deploy.ymlfile in the ``demo-app``` directory and set up the correct repository URI's.

Afterwards 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.


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.