Analyzing and debugging production distributed applications built using a service-oriented or microservices architecture is a challenging task. In this session, we will introduce AWS X-Ray, a new service that makes it easier to identify performance bottlenecks and errors, pinpoint issues to specific service(s) in your application, identify the impact of issues on users of your application, and visualize a request call graph and service call graph for your applications. We will show interactive demos, and code samples for the demo will be available to all session attendees.

1. © 2016, Amazon Web Services, Inc. or its Affiliates. All rights reserved.
Abhishek Singh, Principal Product Manager
December 1, 2016
DEV316
NEW LAUNCH!
Introduction to AWS X-Ray
Overview and Use Cases

2. What to expect from the session
• Overview
• Use cases
• Getting started
• Demo

3. Debugging applications

4. Development vs. production
Traditional debugging involves:
• A development environment
• Search through logs for clues to reproduce the issue
• Set breakpoints in code to stop execution, and inspect variables and call stack
• Add additional log statements as necessary and redeploy application
• Repeat until the issue is fixed
Traditional process of debugging doesn’t scale well to production
applications or those built using a service-oriented, microservice, or
serverless architecture
It’s tedious, repetitive, and time consuming

5. Monolithic vs. service-oriented applications
Applications traditionally developed using a monolithic architecture
Move to service oriented (microservices) architecture to overcome the
drawbacks of a monolithic application architecture
But microservices come with their own set of challenges
Benefits:
• Simple to develop
• Simple to test and debug
• Simple to deploy
• Simple to scale
Drawbacks:
• Hard to iterate fast
• Hard to scale efficiently
• CI/CD time consuming and difficult
• Reliability challenges — a problem
with a single component can take
down the whole app

6. Challenges
Deploying and managing service-oriented applications is more work
compared to monolithic applications
Services such as AWS Lambda, Amazon EC2 Container Service, AWS
Elastic Beanstalk, AWS CloudFormation, etc. make it easier to deploy
and manage applications consisting of hundreds of services
Still hard to debug application issues in production applications due to:
• Cross-service interactions
• Varying log formats across services
• Collecting, aggregating, and collating logs from services

7. Solution
AWS X-Ray makes it easy to:
• Identify performance bottlenecks and errors
• Pinpoint issues to specific service(s) in your application
• Identify impact of issues on users of the application
• Visualize the service call graph of your application

8. How does X-Ray help?

9. X-Ray service

10. X-Ray SDK
Available for Java, .NET, and Node.js
Adds filters to automatically captures metadata for calls to:
• AWS services using the AWS SDK
• Non-AWS services over HTTP and HTTPS
• Databases (MySQL, PostgreSQL, and Amazon DynamoDB)
• Queues (Amazon SQS)
Enables you to get started quickly without having to manually
instrument your application code to log metadata about requests

11. X-Ray daemon
Receives data from the SDK over UDP and acts as a local buffer. Data
is flushed to the backend every second or when the local buffer fills.
Available for Amazon Linux AMI, RHEL, Ubuntu, OS X, and Windows

12. Concepts

13. X-Ray Concepts
Trace End-to-end data related a single request across services
Segments Portions of the trace that correspond to a single service
Sub-segments Remote call or local compute sections within a service
Annotations Business data that can be used to filter traces
Metadata Business data that can be added to the trace but not used
for filtering traces
Errors Normalized error message and stack trace

14. APIs

15. X-Ray API
X-Ray provides a set of APIs to enable you to send, filter,
and retrieve trace data
Raw trace data is available using batch get APIs
You can build your own data analysis applications on top of
the data collected by X-Ray

16. X-Ray API
PutTraceSegments Uploads segment documents to AWS X-Ray
BatchGetTraces Retrieves a list of traces specified by ID
GetServiceGraph Retrieves a document that describes services in your
application and their connections
GetTraceSummaries Retrieves IDs and metadata for traces available for a
specified time frame using an optional filter

17. Segment document
Minimal example
{
"name" : "example.com",
"id" : "70de5b6f19ff9a0a",
"start_time" : 1.478293361271E9,
"trace_id" : "1-581cf771-a006649127e371903a2de979",
"end_time" : 1.478293361449E9
}
Example showing an in-progress segment
{
"name" : "example.com",
"id" : "70de5b6f19ff9a0b",
"start_time" : 1.478293361271E9,
"trace_id" : "1-581cf771-a006649127e371903a2de979",
“in_progress”: true
}

18. Use cases

19. Visualize service call graph

20. Identify impact

21. Identify impact

22. Identify performance bottlenecks

23. Identify performance bottlenecks

24. Identify performance bottlenecks

25. Identify performance bottlenecks

26. Pinpoint issues

27. Pinpoint issues

28. Pinpoint issues

29. Getting started

30. Agent installation (Amazon EC2 Linux)

31. Agent Installation (Amazon EC2 Windows)

32. Agent installation (Amazon ECS)

33. Application instrumentation (Node.js)
//Add aws-xray-sdk package to package.json
var XRay = require('aws-xray-sdk');
var AWS = captureAWS(require('aws-sdk'));
…
XRay.config([XRay.plugins.EC2]);
XRay.captureHTTPs(http);
XRay.setDefaultName('myfrontend-dev');
…
app.use(XRay.express.openSegment());
app.get('/', function(req, res) {
…
});
…
app.use(XRay.express.closeSegment());

34. Demo

35. Pricing

36. X-Ray pricing
Free during the preview. After that:
Free tier
• The first 100,000 traces recorded per month are free
• The first 1,000,000 traces retrieved or scanned per month are free
Additional charges
• Beyond the free tier, traces recorded cost $5.00 per million per month
• Beyond the free tier, traces retrieved or scanned cost $0.50 per million per
month

37. Available today!
The AWS X-Ray service is available in preview today.
Go to https://aws.amazon.com/xray to sign up for the preview.
Documentation: http://docs.aws.amazon.com/xray/latest/devguide/aws-xray.html
.NET Sample: https://github.com/awslabs/aws-xray-dotnet-webapp
Java Sample: https://github.com/awslabs/eb-java-scorekeep/tree/xray
Node.js Sample: https://github.com/awslabs/eb-node-express-sample/tree/xray

38. Thank you!

39. Remember to complete
your evaluations!