Integer referenceId
Identifier of the edge. Unique within a service map.
Date startTime
The start time of the first segment on the edge.
Date endTime
The end time of the last segment on the edge.
EdgeStatistics summaryStatistics
Response statistics for segments on the edge.
List<E> responseTimeHistogram
Histogram describing the prominence of response times on the edge.
List<E> aliases
Aliases for the edge.
Long okCount
The number of requests that completed with a 2xx Success status code.
ErrorStatistics errorStatistics
Information about requests that failed with a 4xx Client Error status code.
FaultStatistics faultStatistics
Information about requests that failed with a 5xx Server Error status code.
Long totalCount
The total number of completed requests.
Double totalResponseTime
The aggregate response time of completed requests.
Long throttleCount
The number of requests that failed with a 419 throttling status code.
Long otherCount
The number of requests that failed with untracked 4xx Client Error status codes.
Long totalCount
The total number of requests that failed with a 4xx Client Error status code.
Date startTime
The start of the time frame for which the graph was generated.
Date endTime
The end of the time frame for which the graph was generated.
List<E> services
The services that have processed a traced request during the specified time frame.
String nextToken
Pagination token. Not used.
Date startTime
The start of the time frame for which to retrieve traces.
Date endTime
The end of the time frame for which to retrieve traces.
Boolean sampling
Set to true
to get summaries for only a subset of available traces.
String filterExpression
Specify a filter expression to retrieve trace summaries for services or requests that meet certain requirements.
String nextToken
Specify the pagination token returned by a previous request to retrieve the next page of results.
List<E> traceSummaries
Trace IDs and metadata for traces that were found in the specified time frame.
Date approximateTime
The start time of this page of results.
Long tracesProcessedCount
The number of traces that were processed to get this set of summaries.
String nextToken
If the requested time frame contained more than one page of results, you can use this token to retrieve the next page. The first page contains the most most recent results, closest to the end of the time frame.
List<E> traceSegmentDocuments
A JSON document defining one or more segments or subsegments. Segments must include the following fields.
Required Segment Document Fields
name
- The name of the service that handled the request.
id
- A 64-bit identifier for the segment, unique among segments in the same trace, in 16 hexadecimal
digits.
trace_id
- A unique identifier that connects all segments and subsegments originating from a single
client request.
start_time
- Time the segment or subsegment was created, in floating point seconds in epoch time,
accurate to milliseconds. For example, 1480615200.010
or 1.480615200010E9
.
end_time
- Time the segment or subsegment was closed. For example, 1480615200.090
or
1.480615200090E9
. Specify either an end_time
or in_progress
.
in_progress
- Set to true
instead of specifying an end_time
to record that
a segment has been started, but is not complete. Send an in progress segment when your application receives a
request that will take a long time to serve, to trace the fact that the request was received. When the response
is sent, send the complete segment to overwrite the in-progress segment.
A trace_id
consists of three numbers separated by hyphens. For example,
1-58406520-a006649127e371903a2de979. This includes:
Trace ID Format
The version number, i.e. 1
.
The time of the original request, in Unix epoch time, in 8 hexadecimal digits. For example, 10:00AM December 2nd,
2016 PST in epoch time is 1480615200
seconds, or 58406520
in hexadecimal.
A 96-bit identifier for the trace, globally unique, in 24 hexadecimal digits.
Integer referenceId
Identifier for the service. Unique within the service map.
String name
The canonical name of the service.
List<E> names
A list of names for the service, including the canonical name.
Boolean root
Indicates that the service was the first service to process a request.
String accountId
Identifier of the AWS account in which the service runs.
String type
The type of service.
AWS Resource - The type of an AWS resource. For example, AWS::EC2::Instance
for a application
running on Amazon EC2 or AWS::DynamoDB::Table
for an Amazon DynamoDB table that the application
used.
AWS Service - The type of an AWS service. For example, AWS::DynamoDB
for downstream calls to Amazon
DynamoDB that didn't target a specific table.
client
- Represents the clients that sent requests to a root service.
remote
- A downstream service of indeterminate type.
String state
The service's state.
Date startTime
The start time of the first segment that the service generated.
Date endTime
The end time of the last segment that the service generated.
List<E> edges
Connections to downstream services.
ServiceStatistics summaryStatistics
Aggregated statistics for the service.
List<E> durationHistogram
Histogram mapping the spread of trace durations
Long okCount
The number of requests that completed with a 2xx Success status code.
ErrorStatistics errorStatistics
Information about requests that failed with a 4xx Client Error status code.
FaultStatistics faultStatistics
Information about requests that failed with a 5xx Server Error status code.
Long totalCount
The total number of completed requests.
Double totalResponseTime
The aggregate response time of completed requests.
String id
The unique identifier for the request that generated the trace's segments and subsegments.
Double duration
The length of time in seconds between the start time of the root segment and the end time of the last segment that completed.
List<E> segments
Segment documents for the segments and subsegments that comprise the trace.
String id
The unique identifier for the request that generated the trace's segments and subsegments.
Double duration
The length of time in seconds between the start time of the root segment and the end time of the last segment that completed.
Double responseTime
The length of time in seconds between the start and end times of the root segment. If the service performs work asynchronously, the response time measures the time before the response is sent to the user, while the duration measures the amount of time before the last traced activity completes.
Boolean hasFault
One or more of the segment documents has a 500 series error.
Boolean hasError
One or more of the segment documents has a 400 series error.
Boolean hasThrottle
One or more of the segment documents has a 429 throttling error.
Boolean isPartial
One or more of the segment documents is in progress.
Http http
Information about the HTTP request served by the trace.
Map<K,V> annotations
Annotations from the trace's segment documents.
List<E> users
Users from the trace's segment documents.
List<E> serviceIds
Service IDs from the trace's segment documents.
AnnotationValue annotationValue
Values of the annotation.
List<E> serviceIds
Services to which the annotation applies.
Copyright © 2017. All rights reserved.