:doc:`CloudWatchRUM <../../rum>` / Paginator / BatchGetRumMetricDefinitions

****************************
BatchGetRumMetricDefinitions
****************************



.. py:class:: CloudWatchRUM.Paginator.BatchGetRumMetricDefinitions

  ::

    
    paginator = client.get_paginator('batch_get_rum_metric_definitions')

  
  

  .. py:method:: paginate(**kwargs)

    Creates an iterator that will paginate through responses from :py:meth:`CloudWatchRUM.Client.batch_get_rum_metric_definitions`.

    See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/rum-2018-05-10/BatchGetRumMetricDefinitions>`_    


    **Request Syntax**
    ::

      response_iterator = paginator.paginate(
          AppMonitorName='string',
          Destination='CloudWatch'|'Evidently',
          DestinationArn='string',
          PaginationConfig={
              'MaxItems': 123,
              'PageSize': 123,
              'StartingToken': 'string'
          }
      )
      
    :type AppMonitorName: string
    :param AppMonitorName: **[REQUIRED]** 

      The name of the CloudWatch RUM app monitor that is sending the metrics.

      

    
    :type Destination: string
    :param Destination: **[REQUIRED]** 

      The type of destination that you want to view metrics for. Valid values are ``CloudWatch`` and ``Evidently``.

      

    
    :type DestinationArn: string
    :param DestinationArn: 

      This parameter is required if ``Destination`` is ``Evidently``. If ``Destination`` is ``CloudWatch``, do not use this parameter.

       

      This parameter specifies the ARN of the Evidently experiment that corresponds to the destination.

      

    
    :type PaginationConfig: dict
    :param PaginationConfig: 

      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.

        

      
    
    
    :rtype: dict
    :returns: 
      
      **Response Syntax**

      
      ::

        {
            'MetricDefinitions': [
                {
                    'MetricDefinitionId': 'string',
                    'Name': 'string',
                    'ValueKey': 'string',
                    'UnitLabel': 'string',
                    'DimensionKeys': {
                        'string': 'string'
                    },
                    'EventPattern': 'string',
                    'Namespace': 'string'
                },
            ],
            
        }
        
      **Response Structure**

      

      - *(dict) --* 
        

        - **MetricDefinitions** *(list) --* 

          An array of structures that display information about the metrics that are sent by the specified app monitor to the specified destination.

          
          

          - *(dict) --* 

            A structure that displays the definition of one extended metric that RUM sends to CloudWatch or CloudWatch Evidently. For more information, see `Additional metrics that you can send to CloudWatch and CloudWatch Evidently <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-RUM-vended-metrics.html>`__.

            
            

            - **MetricDefinitionId** *(string) --* 

              The ID of this metric definition.

              
            

            - **Name** *(string) --* 

              The name of the metric that is defined in this structure.

              
            

            - **ValueKey** *(string) --* 

              The field within the event object that the metric value is sourced from.

              
            

            - **UnitLabel** *(string) --* 

              Use this field only if you are sending this metric to CloudWatch. It defines the CloudWatch metric unit that this metric is measured in.

              
            

            - **DimensionKeys** *(dict) --* 

              This field is a map of field paths to dimension names. It defines the dimensions to associate with this metric in CloudWatch The value of this field is used only if the metric destination is ``CloudWatch``. If the metric destination is ``Evidently``, the value of ``DimensionKeys`` is ignored.

              
              

              - *(string) --* 
                

                - *(string) --* 
          
        
            

            - **EventPattern** *(string) --* 

              The pattern that defines the metric. RUM checks events that happen in a user's session against the pattern, and events that match the pattern are sent to the metric destination.

               

              If the metrics destination is ``CloudWatch`` and the event also matches a value in ``DimensionKeys``, then the metric is published with the specified dimensions.

              
            

            - **Namespace** *(string) --* 

              If this metric definition is for a custom metric instead of an extended metric, this field displays the metric namespace that the custom metric is published to.

              
        
      
    