Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Preparación para la indexación de flotas

Con la indexación de AWS IoT flotas, puede buscar y agregar datos utilizando el nombre reservado shadow ()$package. También puede agrupar AWS IoT cosas consultando los grupos de cosas dinámicos Sombra con nombre reservado y los grupos de cosas dinámicos. Por ejemplo, puedes encontrar información sobre qué AWS IoT cosas usan una versión de paquete específica, qué no tienen instalada una versión de paquete específica o no tienen ninguna versión de paquete instalada. Puede obtener más información mediante la combinación de atributos. Por ejemplo, identificar cosas que tienen una versión específica y que son de un tipo de cosa específico (como la versión 1.0.0 y el tipo de cosa de pump_sensor). Para obtener más información, consulte Indexación de flotas.

Establecer la sombra $package como origen de datos

Para utilizar la indexación de flotas con el Catálogo de paquetes de software, debe habilitar la indexación de flotas, establecer la sombra con nombre como origen de datos y definir $package como filtro de sombra con nombre. Si no ha activado la indexación de flotas, puede habilitarla en este proceso. Desde AWS IoT Core en la consola, abra Configuración, elija Gestionar indexación y, a continuación, Añadir sombras con nombre, Añadir paquetes y versiones de software del dispositivo y Actualizar. Para obtener más información, consulte Gestionar la indexación de flotas.

Alternativamente, puede activar la indexación de flotas cuando cree su primer paquete. Cuando aparezca el cuadro de diálogo Habilitar las dependencias para la gestión de paquetes, elija la opción de añadir paquetes y versiones del software del dispositivo como fuentes de datos para la indexación de la flota. Al seleccionar esta opción, también habilita la indexación de la flota.

Las métricas se muestran en la consola

En la página de detalles del paquete de software de la AWS IoT consola, el panel Discovery muestra las métricas estándar recopiladas de forma $package oculta.

Para ver otro método para obtener información sobre la recopilación de la distribución de versiones de paquetes, consulte Recopilación de la distribución de versiones de paquetes mediante getBucketsAggregation.

Patrones de consulta

La indexación de flotas con el Catálogo de paquetes de software utiliza la mayoría de las características compatibles (por ejemplo, términos y frases y campos de búsqueda) que son estándar para la indexación de flotas. La excepción es que las consultas comparison y range no están disponibles para la clave reservada denominada sombra ($package) version. Sin embargo, estas consultas están disponibles para la clave attributes. Para obtener más información, consulte Sintaxis de consultas.

Datos de ejemplo

Nota: para obtener información sobre la sombra con nombre reservado y su estructura, consulte Sombra con nombre reservado.

En este ejemplo, se nombra un primer dispositivo AnyThing y tiene instalados los siguientes paquetes:

La sombra tiene el siguiente aspecto:

{
    "state": {
        "reported": {
            "SamplePackage": {
                "version": "1.0.0",
                "attributes": {
                    "s3UrlForSamplePackage": "https://EXAMPIEBUCKET.s3.us-west-2.amazonaws.com/exampleCodeFile1",
                    "packageID": "1111"
                    }
            }
        }
    }
}

Se nombra un segundo dispositivo AnotherThing y tiene instalado el siguiente paquete:

La sombra tiene el siguiente aspecto:

{
    "state": {
        "reported": {
            "SamplePackage": {
                "version": "1.0.0",
                "attributes": {
                    "s3UrlForSamplePackage": "https://EXAMPIEBUCKET.s3.us-west-2.amazonaws.com/exampleCodeFile1",
                    "packageID": "1111"
                }
            },
            "OtherPackage": {
                "version": "1.2.5",
                "attributes": {
                    "s3UrlForOtherPackage": "https://EXAMPIEBUCKET.s3.us-west-2.amazonaws.com/exampleCodeFile2",
                    "packageID": "2222"
                    }
            },
        }
    }
}

Consultas de ejemplo

En la siguiente tabla se muestran ejemplos de consultas basadas en las sombras de los dispositivos de ejemplo para AnyThing y AnotherThing. Para más información, consulte Ejemplo de consultas sobre cosas.

Recopilación de la distribución de las versiones del paquete mediante getBucketsAggregation

Además del panel Discovery de la AWS IoT consola, también puede obtener información sobre la distribución de las versiones del paquete mediante la GetBucketsAggregationAPIoperación. Para obtener la información de distribución de la versión del paquete, necesita lo siguiente:

Para obtener más información, consulte la sección Campos personalizados de la indexación de AWS IoT flotas.