CloudWatchApplicationSignals / Paginator / ListServices

ListServices#

class CloudWatchApplicationSignals.Paginator.ListServices#
paginator = client.get_paginator('list_services')
paginate(**kwargs)#

Creates an iterator that will paginate through responses from CloudWatchApplicationSignals.Client.list_services().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    StartTime=datetime(2015, 1, 1),
    EndTime=datetime(2015, 1, 1),
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters:
  • StartTime (datetime) –

    [REQUIRED]

    The start of the time period to retrieve information about. When used in a raw HTTP Query API, it is formatted as be epoch time in seconds. For example: 1698778057

    Your requested start time will be rounded to the nearest hour.

  • EndTime (datetime) –

    [REQUIRED]

    The end of the time period to retrieve information about. When used in a raw HTTP Query API, it is formatted as be epoch time in seconds. For example: 1698778057

    Your requested start time will be rounded to the nearest hour.

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

    • PageSize (integer) –

      The size of each page.

    • StartingToken (string) –

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

Return type:

dict

Returns:

Response Syntax

{
    'StartTime': datetime(2015, 1, 1),
    'EndTime': datetime(2015, 1, 1),
    'ServiceSummaries': [
        {
            'KeyAttributes': {
                'string': 'string'
            },
            'AttributeMaps': [
                {
                    'string': 'string'
                },
            ],
            'MetricReferences': [
                {
                    'Namespace': 'string',
                    'MetricType': 'string',
                    'Dimensions': [
                        {
                            'Name': 'string',
                            'Value': 'string'
                        },
                    ],
                    'MetricName': 'string'
                },
            ]
        },
    ],

}

Response Structure

  • (dict) –

    • StartTime (datetime) –

      The start of the time period that the returned information applies to. When used in a raw HTTP Query API, it is formatted as be epoch time in seconds. For example: 1698778057

      This displays the time that Application Signals used for the request. It might not match your request exactly, because it was rounded to the nearest hour.

    • EndTime (datetime) –

      The end of the time period that the returned information applies to. When used in a raw HTTP Query API, it is formatted as be epoch time in seconds. For example: 1698778057

      This displays the time that Application Signals used for the request. It might not match your request exactly, because it was rounded to the nearest hour.

    • ServiceSummaries (list) –

      An array of structures, where each structure contains some information about a service. To get complete information about a service, use GetService.

      • (dict) –

        This structure contains information about one of your services that was discoverd by Application Signals

        • KeyAttributes (dict) –

          This is a string-to-string map that help identify the objects discovered by Application Signals. It can include the following fields.

          • Type designates the type of object this is.

          • ResourceType specifies the type of the resource. This field is used only when the value of the Type field is Resource or AWS::Resource.

          • Name specifies the name of the object. This is used only if the value of the Type field is Service, RemoteService, or AWS::Service.

          • Identifier identifies the resource objects of this resource. This is used only if the value of the Type field is Resource or AWS::Resource.

          • Environment specifies the location where this object is hosted, or what it belongs to.

          • (string) –

            • (string) –

        • AttributeMaps (list) –

          This structure contains one or more string-to-string maps that help identify this service. It can include platform attributes, application attributes, and telemetry attributes.

          Platform attributes contain information the service’s platform.

          • PlatformType defines the hosted-in platform.

          • EKS.Cluster is the name of the Amazon EKS cluster.

          • K8s.Cluster is the name of the self-hosted Kubernetes cluster.

          • K8s.Namespace is the name of the Kubernetes namespace in either Amazon EKS or Kubernetes clusters.

          • K8s.Workload is the name of the Kubernetes workload in either Amazon EKS or Kubernetes clusters.

          • K8s.Node is the name of the Kubernetes node in either Amazon EKS or Kubernetes clusters.

          • K8s.Pod is the name of the Kubernetes pod in either Amazon EKS or Kubernetes clusters.

          • EC2.AutoScalingGroup is the name of the Amazon EC2 Auto Scaling group.

          • EC2.InstanceId is the ID of the Amazon EC2 instance.

          • Host is the name of the host, for all platform types.

          Applciation attributes contain information about the application.

          • AWS.Application is the application’s name in Amazon Web Services Service Catalog AppRegistry.

          • AWS.Application.ARN is the application’s ARN in Amazon Web Services Service Catalog AppRegistry.

          Telemetry attributes contain telemetry information.

          • Telemetry.SDK is the fingerprint of the OpenTelemetry SDK version for instrumented services.

          • Telemetry.Agent is the fingerprint of the agent used to collect and send telemetry data.

          • Telemetry.Source Specifies the point of application where the telemetry was collected or specifies what was used for the source of telemetry data.

          • (dict) –

            • (string) –

              • (string) –

        • MetricReferences (list) –

          An array of structures that each contain information about one metric associated with this service.

          • (dict) –

            This structure contains information about one CloudWatch metric associated with this entity discovered by Application Signals.

            • Namespace (string) –

              The namespace of the metric. For more information, see CloudWatchNamespaces.

            • MetricType (string) –

              Used to display the appropriate statistics in the CloudWatch console.

            • Dimensions (list) –

              An array of one or more dimensions that further define the metric. For more information, see CloudWatchDimensions.

              • (dict) –

                A dimension is a name/value pair that is part of the identity of a metric. Because dimensions are part of the unique identifier for a metric, whenever you add a unique name/value pair to one of your metrics, you are creating a new variation of that metric. For example, many Amazon EC2 metrics publish InstanceId as a dimension name, and the actual instance ID as the value for that dimension.

                You can assign up to 30 dimensions to a metric.

                • Name (string) –

                  The name of the dimension. Dimension names must contain only ASCII characters, must include at least one non-whitespace character, and cannot start with a colon ( :). ASCII control characters are not supported as part of dimension names.

                • Value (string) –

                  The value of the dimension. Dimension values must contain only ASCII characters and must include at least one non-whitespace character. ASCII control characters are not supported as part of dimension values.

            • MetricName (string) –

              The name of the metric.