Crear una configuración del analizador de red

A fin de poder supervisar las puertas de enlace o los dispositivos inalámbricos, debe crear una configuración para el analizador de redes. Cuando cree la configuración, solo tiene que especificar un nombre de configuración. Puede personalizar los ajustes de configuración y agregar los recursos que desee supervisar a la configuración incluso después de crearla. Los valores de configuración determinan la información de mensajería de rastreo que recibirá para esos recursos.

En función de los recursos que desee supervisar y del nivel de información que desee recibir de ellos, es posible que desee crear varias configuraciones. Por ejemplo, puede crear una configuración que muestre solo la información de error de un conjunto de puertas de enlace de su Cuenta de AWS. También puede crear una configuración que muestre toda la información sobre el dispositivo inalámbrico que desee supervisar.

En las siguientes secciones se muestran las distintas opciones de configuración y cómo crear la configuración.

Opciones de configuración

Al crear o actualizar la configuración del analizador de redes, también puede personalizar los siguientes parámetros para filtrar la información del flujo de registro.

• Información del marco

  Esta configuración es la información del marco de los recursos del dispositivo inalámbrico para los mensajes de rastreo. La información del marco se puede utilizar para depurar la comunicación entre el servidor de red y los dispositivos finales. Está habilitada de forma predeterminada.

• Niveles de registro

  Puede ver los registros de información o errores, o puede desactivar el registro.

  • Información

    Los registros con un nivel de registro de información son más detallados y contienen tanto secuencias de registro de errores como secuencias de registro informativos. Los registros informativos se pueden usar para ver los cambios en el estado de un dispositivo o puerta de enlace.

    nota

    La recopilación de secuencias de registros más detallados puede dar lugar costes adicionales. Para obtener más información acerca de los precios, consulte Precios de AWS IoT Core.

  • Error

    Los registros con un nivel de registro de error son menos detallados y solo muestran información sobre errores. Puede usar estos registros cuando una aplicación tenga un error, como un error de conexión de un dispositivo. Al utilizar la información del flujo de registro, puede identificar y solucionar los errores de los recursos de su flota.

Crear una configuración con la consola

Puede crear una configuración de analizador de redes y personalizar los parámetros opcionales mediante la consola de AWS IoT o la API de AWS IoT Wireless. También puede crear varias configuraciones y, posteriormente, eliminar las configuraciones que ya no utilice.

Crear una configuración del analizador de red

1. Abra el hub de Network Analyzer de la consola de AWS IoT y seleccione Crear configuración.

2. Especifique las opciones de configuración.

   • El nombre, la descripción y las etiquetas

     Especifique un Nombre de configuración único que conste solo de letras, números, guiones o guiones bajos. Utilice el campo Descripción opcional para proporcionar información sobre la configuración, y el campo Etiquetas para añadir pares de metadatos clave-valor sobre la configuración. Para obtener más información acerca del nombre y la descripción de los recursos, consulte Descripción de los recursos de AWS IoT Wireless.

   • Opciones de configuración

     Elija si desea deshabilitar la información del marco y utilice Seleccionar niveles de registro para elegir los niveles de registro que desea usar en los registros de mensajes de rastreo. Seleccione Siguiente.

3. Agregar recursos a la configuración. Puede agregar sus recursos ahora o puede elegir Crear y, a continuación, agregar los recursos más adelante. Para agregar recursos más adelante, seleccione Crear.

   En la página del hub de Network Analyzer, verá la configuración que creó junto con sus ajustes. Para ver los detalles de la nueva configuración, elija el nombre de la configuración.

Eliminar la configuración del analizador de red

Puede crear varias configuraciones de analizadores de red en función de los recursos que desee supervisar y del nivel de información de mensajería de rastreo que desee recibir de ellos.

Para eliminar las configuraciones de la consola

1. Vaya al hub de Network Analyzer de la consola de AWS IoT y elija la configuración que desee eliminar.

2. Elija Acciones y, a continuación, elija Eliminar.

Crear una configuración con la API

Para crear una configuración de analizador de red mediante la API, utilice la operación de API CreateNetworkAnalyzerConfiguration o el comando CLI create-network-analyzer-configuration.

Cuando cree la configuración, solo tiene que especificar un nombre de configuración. También puede usar esta operación de API para especificar los ajustes de configuración y agregar recursos al crear la configuración. Si lo prefiere, puede especificarlos más adelante mediante la operación API UpdateNetworkAnalyzerConfiguration o el comando update-network-analyzer-configuration de la CLI.

• Crear una configuración

  Cuando cree su configuración, debe especificar un nombre. Por ejemplo, el comando siguiente crea una configuración proporcionando solo un nombre y una descripción opcional. De forma predeterminada, la configuración tiene activada la información del marco y utiliza un nivel de registro de INFO.

  aws iotwireless create-network-analyzer-configuration \ 
      --configuration-name My_Network_Analyzer_Config \ 
      --description "My first network analyzer configuration"                 

  Al ejecutar este comando, se muestran el ARN y el ID de la configuración del analizador de redes.

  {
      "Arn": "arn:aws:iotwireless:us-east-1:123456789012:NetworkAnalyzerConfiguration/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
      "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d"
  }

• Crear una configuración con recursos

  Para personalizar estos ajustes de configuración, utilice el parámetro trace-content. Para agregar recursos, utilice los parámetros WirelessDevices y WirelessGateways a fin de especificar las puertas de enlace y los dispositivos que desea agregar a la configuración. Por ejemplo, el siguiente comando actualiza los parámetros de configuración y agrega a esta los recursos inalámbricos, especificados por sus WirelessGatewayID y WirelessDeviceID.

  aws iotwireless create-network-analyzer-configuration \ 
      --configuration-name My_NetworkAnalyzer_Config \ 
      --trace-content WirelessDeviceFrameInfo=DISABLED,LogLevel="ERROR" \ 
      --wireless-gateways "12345678-a1b2-3c45-67d8-e90fa1b2c34d" "90123456-de1f-2b3b-4c5c-bb1112223cd1"   
      --wireless-devices "1ffd32c8-8130-4194-96df-622f072a315f"

  El siguiente ejemplo muestra los resultados del comando:

  {
      "Arn": "arn:aws:iotwireless:us-east-1:123456789012:NetworkAnalyzerConfiguration/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
      "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d"
  }

Enumerar las configuraciones del analizador de red

Puede crear varias configuraciones de analizadores de red en función de los recursos que desee supervisar y del nivel de detalle de la información de mensajería de rastreo que desee recibir para los recursos. Después de crear estas configuraciones, puede usar la operación de API ListNetworkAnalyzerConfigurations o el comando CLI list-network-analyzer-configuration para obtener una lista de estas configuraciones.

aws iotwireless list-network-analyzer-configurations

Al ejecutar este comando, se muestran todas las configuraciones del analizador de red en su Cuenta de AWS. También puede usar el parámetro max-results para especificar cuántas configuraciones desea mostrar. El ejemplo siguiente muestra el ejemplo de salida de la ejecución de este comando.

{
   "NetworkAnalyzerConfigurationList": [ 
      { 
         "Arn": "arn:aws:iotwireless:us-east-1:123456789012:NetworkAnalyzerConfiguration/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
         "Name": "My_Network_Analyzer_Config1"
      },
      { 
         "Arn": "arn:aws:iotwireless:us-east-1:123456789012:NetworkAnalyzerConfiguration/90123456-a1a2-9a87-65b4-c12bf3c2d09a",
         "Name": "My_Network_Analyzer_Config2"
      }
   ]
}

Eliminar la configuración del analizador de red

Puede eliminar una configuración que ya no utilice con la operación de API DeleteNetworkAnalyzerConfiguration o el comando CLI delete-network-analyzer-configuration.

aws iotwireless delete-network-analyzer-configuration \ 
    --configuration-name My_NetworkAnalyzer_Config

Este comando no proporciona ningún resultado. Para ver las configuraciones disponibles, puede utilizar la operación API de ListNetworkAnalyzerConfigurations.

Siguientes pasos

Ahora que ha creado una configuración de analizador de redes, puede agregar recursos a la configuración o actualizar los ajustes de configuración. Para obtener más información, consulte Agregar recursos y actualizar la configuración del analizador de red.