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 mediante el nombre reservado shadow ()`$package`. También puede agrupar AWS IoT cosas consultando los grupos de cosas [dinámicos [Sombra con nombre reservado](preparing-to-use-software-package-catalog.md#reserved-named-shadow) y los grupos de cosas dinámicos](https://docs.aws.amazon.com/iot/latest/developerguide/dynamic-thing-groups.html). 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\$1sensor). Para obtener más información, consulte [Indexación de flotas](https://docs.aws.amazon.com/iot/latest/developerguide/iot-indexing.html).
## 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](https://console.aws.amazon.com/iot/home) 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](https://docs.aws.amazon.com/iot/latest/developerguide/managing-fleet-index.html#thing-index).
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.
**nota**
Habilitar la indexación de flotas para el Catálogo de Paquetes de Software incurre en costes de servicio estándar. Para obtener más información, consulte [Precios de AWS IoT Device Management](https://aws.amazon.com/iot-device-management/pricing/).
## Las métricas se muestran en la consola
![\[Imagen de métricas estándar\]](http://docs.aws.amazon.com/es_es/iot/latest/developerguide/images/package-catalog-discovery-metrics.png)
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.
+ El gráfico de **distribución de la versión actual** muestra el número de dispositivos y el porcentaje de las 10 versiones más recientes del paquete que están asociadas a un elemento AWS IoT de entre todos los dispositivos asociados a este paquete de software. **Nota:** Si el paquete de software tiene más versiones de paquete que las indicadas en el gráfico, puede encontrarlas agrupadas en **Otras**.
+ El **gráfico histórico** muestra la cantidad de dispositivos asociados a las versiones de paquetes seleccionadas durante un período de tiempo específico. Al principio, el gráfico está vacío hasta que seleccione hasta 5 versiones del paquete y defina el rango de fechas y el intervalo de tiempo. Para seleccionar los parámetros del gráfico, elija **Configuración**. Los datos que se muestran en el **gráfico histórico** pueden ser diferentes a los del gráfico de **distribución de la versión actual** debido a la diferencia en el número de versiones de paquetes que se muestran y también a que puede elegir qué versiones de paquetes analizar en el **gráfico histórico**. **Nota:** Cuando selecciona una versión de paquete para visualizarla, se tiene en cuenta para el número máximo de límites de las métricas de la flota. Para más información, consulte [Límites y cuotas de indexación de flotas](https://docs.aws.amazon.com/general/latest/gr/iot_device_management.html#fleet-indexing-limits).
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`](https://docs.aws.amazon.com/iot/latest/developerguide/preparing-fleet-indexing.html#package-version-distribution).
## 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 estándar (como, por ejemplo, términos, frases y campos de búsqueda). Sin embargo, los operadores de comparación (por ejemplo, menor que `<` y mayor que `>`) y las consultas de `range` no están disponibles para la clave `version` de sombra con nombre reservado (`$package`). Estas consultas están disponibles para la clave `attributes`. Para obtener más información, consulte [Sintaxis de consultas](https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html).
### Datos de ejemplo
**Nota:** para obtener información sobre la sombra con nombre reservado y su estructura, consulte [Sombra con nombre reservado](https://docs.aws.amazon.com/iot/latest/developerguide/preparing-to-use-software-package-catalog.html#reserved-named-shadow).
En este ejemplo, se nombra un primer dispositivo `AnyThing` y tiene instalados los siguientes paquetes:
+ Paquete de software: `SamplePackage`
Versión de paquete: `1.0.0`
ID del paquete. `1111`
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:
+ Paquete de software: `SamplePackage`
Versión de paquete: `1.0.0`
ID del paquete. `1111`
+ Paquete de software: `OtherPackage`
Versión de paquete: `1.2.5`
ID del paquete. `2222`
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](https://docs.aws.amazon.com/iot/latest/developerguide/example-queries.html).
**Última versión de AWS IoT Device Tester for FreeRTOS**
| **Información solicitada** | **Query** | **Resultado** |
| --- | --- | --- |
| Cosas que tienen instalada una versión de paquete específica | `shadow.name.$package.reported.SamplePackage.version:1.0.0` | `AnyThing`, `OtherThing` |
| Cosas que tienen instalada una versión de paquete específica | `NOT shadow.name.$package.reported.OtherPackage.version:1.2.5` | `AnyThing` |
| Cualquier dispositivo que utilice una versión de paquete cuyo identificador de paquete sea superior a 1500 | `shadow.name.$package.reported.*.attributes.packageID>1500"` | `OtherThing` |
| Cosas que tienen un paquete específico instalado y tienen más de un paquete instalado | `shadow.name.$package.reported.SamplePackage.version:1.0.0 AND shadow.name.$package.reported.totalCount:2` | `OtherThing` |
## 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 operación de [https://docs.aws.amazon.com/iot/latest/apireference/API_GetBucketsAggregation.html](https://docs.aws.amazon.com/iot/latest/apireference/API_GetBucketsAggregation.html)API. Para obtener la información de distribución de la versión del paquete, necesita lo siguiente:
+ Defina un campo personalizado en la indexación de flotas para cada paquete de software. **Nota:** La creación de campos personalizados cuenta para las cuotas de [servicio de indexación de la flota AWS IoT](https://docs.aws.amazon.com/general/latest/gr/iot_device_management.html#fleet-indexing-limits).
+ Formatee el campo personalizado de la siguiente manera:
`shadow.name.$package.reported..version`
Para obtener más información, consulta la sección [Campos personalizados](https://docs.aws.amazon.com/iot/latest/developerguide/managing-fleet-index.html#custom-field) de la indexación de AWS IoT flotas.