:doc:`IoTWireless <../../iotwireless>` / Client / get_wireless_device_statistics

******************************
get_wireless_device_statistics
******************************



.. py:method:: IoTWireless.Client.get_wireless_device_statistics(**kwargs)

  

  Gets operating information about a wireless device.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/iotwireless-2020-11-22/GetWirelessDeviceStatistics>`_  


  **Request Syntax**
  ::

    response = client.get_wireless_device_statistics(
        WirelessDeviceId='string'
    )
    
  :type WirelessDeviceId: string
  :param WirelessDeviceId: **[REQUIRED]** 

    The ID of the wireless device for which to get the data.

    

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

    
    ::

      {
          'WirelessDeviceId': 'string',
          'LastUplinkReceivedAt': 'string',
          'LoRaWAN': {
              'DevEui': 'string',
              'FPort': 123,
              'DataRate': 123,
              'Frequency': 123,
              'Timestamp': 'string',
              'Gateways': [
                  {
                      'GatewayEui': 'string',
                      'Snr': 123.0,
                      'Rssi': 123.0
                  },
              ],
              'PublicGateways': [
                  {
                      'ProviderNetId': 'string',
                      'Id': 'string',
                      'Rssi': 123.0,
                      'Snr': 123.0,
                      'RfRegion': 'string',
                      'DlAllowed': True|False
                  },
              ]
          },
          'Sidewalk': {
              'Rssi': 123,
              'BatteryLevel': 'normal'|'low'|'critical',
              'Event': 'discovered'|'lost'|'ack'|'nack'|'passthrough',
              'DeviceState': 'Provisioned'|'RegisteredNotSeen'|'RegisteredReachable'|'RegisteredUnreachable'
          }
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **WirelessDeviceId** *(string) --* 

        The ID of the wireless device.

        
      

      - **LastUplinkReceivedAt** *(string) --* 

        The date and time when the most recent uplink was received.

         

        .. note::

          

          This value is only valid for 3 months.

          

        
      

      - **LoRaWAN** *(dict) --* 

        Information about the wireless device's operations.

        
        

        - **DevEui** *(string) --* 

          The DevEUI value.

          
        

        - **FPort** *(integer) --* 

          The FPort value.

          
        

        - **DataRate** *(integer) --* 

          The DataRate value.

          
        

        - **Frequency** *(integer) --* 

          The device's channel frequency in Hz.

          
        

        - **Timestamp** *(string) --* 

          The date and time of the metadata.

          
        

        - **Gateways** *(list) --* 

          Information about the gateways accessed by the device.

          
          

          - *(dict) --* 

            LoRaWAN gateway metatdata.

            
            

            - **GatewayEui** *(string) --* 

              The gateway's EUI value.

              
            

            - **Snr** *(float) --* 

              The SNR value.

              
            

            - **Rssi** *(float) --* 

              The RSSI value.

              
        
      
        

        - **PublicGateways** *(list) --* 

          Information about the LoRaWAN public network accessed by the device.

          
          

          - *(dict) --* 

            LoRaWAN public gateway metadata.

            
            

            - **ProviderNetId** *(string) --* 

              The ID of the LoRaWAN public network provider.

              
            

            - **Id** *(string) --* 

              The ID of the gateways that are operated by the network provider.

              
            

            - **Rssi** *(float) --* 

              The RSSI (received signal strength indicator) value.

              
            

            - **Snr** *(float) --* 

              The SNR (signal to noise ratio) value.

              
            

            - **RfRegion** *(string) --* 

              The frequency band (RFRegion) value.

              
            

            - **DlAllowed** *(boolean) --* 

              Boolean that indicates whether downlink is allowed using the network.

              
        
      
    
      

      - **Sidewalk** *(dict) --* 

        MetaData for Sidewalk device.

        
        

        - **Rssi** *(integer) --* 

          The RSSI value.

          
        

        - **BatteryLevel** *(string) --* 

          Sidewalk device battery level.

          
        

        - **Event** *(string) --* 

          Sidewalk device status notification.

          
        

        - **DeviceState** *(string) --* 

          Device state defines the device status of sidewalk device.

          
    
  
  **Exceptions**
  
  *   :py:class:`IoTWireless.Client.exceptions.ValidationException`

  
  *   :py:class:`IoTWireless.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`IoTWireless.Client.exceptions.ResourceNotFoundException`

  
  *   :py:class:`IoTWireless.Client.exceptions.InternalServerException`

  
  *   :py:class:`IoTWireless.Client.exceptions.ThrottlingException`

  