Select your cookie preferences

We use cookies and similar tools to enhance your experience, provide our services, deliver relevant advertising, and make improvements. Approved third parties also use these tools to help us deliver advertising and provide certain site features.

BatchGetTraces

class XRay.Paginator.BatchGetTraces
paginator = client.get_paginator('batch_get_traces')
paginate(**kwargs)

Creates an iterator that will paginate through responses from XRay.Client.batch_get_traces().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    TraceIds=[
        'string',
    ],
    PaginationConfig={
        'MaxItems': 123,
        'StartingToken': 'string'
    }
)
Parameters
  • TraceIds (list) --

    [REQUIRED]

    Specify the trace IDs of requests for which to retrieve segments.

    • (string) --
  • PaginationConfig (dict) --

    A dictionary that provides parameters to control pagination.

    • MaxItems (integer) --

      The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

    • StartingToken (string) --

      A token to specify where to start paginating. This is the NextToken from a previous response.

Return type

dict

Returns

Response Syntax

{
    'Traces': [
        {
            'Id': 'string',
            'Duration': 123.0,
            'LimitExceeded': True|False,
            'Segments': [
                {
                    'Id': 'string',
                    'Document': 'string'
                },
            ]
        },
    ],
    'UnprocessedTraceIds': [
        'string',
    ],

}

Response Structure

  • (dict) --

    • Traces (list) --

      Full traces for the specified requests.

      • (dict) --

        A collection of segment documents with matching trace IDs.

        • Id (string) --

          The unique identifier for the request that generated the trace's segments and subsegments.

        • Duration (float) --

          The length of time in seconds between the start time of the root segment and the end time of the last segment that completed.

        • LimitExceeded (boolean) --

          LimitExceeded is set to true when the trace has exceeded the Trace document size limit. For more information about this limit and other X-Ray limits and quotas, see Amazon Web Services X-Ray endpoints and quotas.

        • Segments (list) --

          Segment documents for the segments and subsegments that comprise the trace.

          • (dict) --

            A segment from a trace that has been ingested by the X-Ray service. The segment can be compiled from documents uploaded with PutTraceSegments, or an inferred segment for a downstream service, generated from a subsegment sent by the service that called it.

            For the full segment document schema, see Amazon Web Services X-Ray Segment Documents in the Amazon Web Services X-Ray Developer Guide .

            • Id (string) --

              The segment's ID.

            • Document (string) --

              The segment document.

    • UnprocessedTraceIds (list) --

      Trace IDs of requests that haven't been processed.

      • (string) --