As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Preparação da indexação de frota
Com a indexação de AWS IoT frotas, você pode pesquisar e agregar dados usando o nome reservado shadow ()`$package`. Você também pode agrupar AWS IoT coisas consultando os [grupos [Sombra nomeada reservada](preparing-to-use-software-package-catalog.md#reserved-named-shadow) de coisas dinâmicas](https://docs.aws.amazon.com/iot/latest/developerguide/dynamic-thing-groups.html). Por exemplo, você pode encontrar informações sobre quais AWS IoT itens usam uma versão de pacote específica, não têm uma versão de pacote específica instalada ou não têm nenhuma versão de pacote instalada. Você pode obter mais informações combinando atributos. Por exemplo, identificar objetos que têm uma versão específica e são de um tipo específico (como a versão 1.0.0 e o tipo de objeto pump\$1sensor). Para obter mais informações, consulte [Indexação de frota](https://docs.aws.amazon.com/iot/latest/developerguide/iot-indexing.html).
## Definição da `$package` sombra como fonte de dados
Para usar a indexação de frota com o Catálogo de pacotes de software, você deve habilitar a indexação de frota, definir a sombra nomeada como a fonte de dados e definir `$package` como o filtro de sombra nomeado. Se você não ativou a indexação de frota, poderá ativá-la nesse processo. Em [AWS IoT Core](https://console.aws.amazon.com/iot/home) no console, abra **Configurações**, selecione **Gerenciar indexação**, em seguida **Adicionar sombras nomeadas**, **Adicionar pacotes de software do dispositivo e versões**, e **Atualizar**. Para obter mais informações, consulte [Como gerenciar indexação de objetos](https://docs.aws.amazon.com/iot/latest/developerguide/managing-fleet-index.html#thing-index).
Como alternativa, você pode ativar a indexação da frota ao criar seu primeiro pacote. Quando a caixa de diálogo **Habilitar dependências para gerenciamento de pacotes** for exibida, escolha a opção de adicionar pacotes e versões de software do dispositivo como fontes de dados à indexação da frota. Ao selecionar essa opção, você também ativa a indexação da frota.
**nota**
Habilitar a indexação de frota para o Catálogo de pacotes de software gera custos de serviço padrão. Para obter mais informações, consulte a opção [AWS IoT Device Management, Preços](https://aws.amazon.com/iot-device-management/pricing/).
## Métricas serão exibidos no console
![\[Imagem de métricas padrão\]](http://docs.aws.amazon.com/pt_br/iot/latest/developerguide/images/package-catalog-discovery-metrics.png)
Na página de detalhes do pacote de software do AWS IoT console, o painel **Discovery** exibe métricas padrão ingeridas pela `$package` sombra.
+ O gráfico de **distribuição da versão atual** mostra o número de dispositivos e a porcentagem das 10 versões mais recentes do pacote que estão associadas a AWS IoT alguma coisa de todos os dispositivos associados a esse pacote de software. **Nota:** Se o pacote de software tiver mais versões do pacote do que as identificadas no gráfico, você poderá encontrá-las agrupadas em **Outros**.
+ O gráfico **Histórico** mostra o número de dispositivos associados às versões selecionadas do pacote em um período de tempo especificado. O gráfico fica inicialmente vazio até que você selecione até cinco versões do pacote e defina o intervalo de datas e o intervalo de tempo. Para selecionar os parâmetros do gráfico, escolha **Configurações**. Os dados exibidos no gráfico **Histórico** podem ser diferentes do gráfico de **distribuição da versão atual** devido à diferença no número de versões do pacote que eles exibem e também porque você pode escolher quais versões do pacote analisar no gráfico **Histórico**. **Nota:** quando você seleciona uma versão do pacote para visualizar, ela conta para o número máximo de limites de métricas da frota. Para obter mais informações, consulte [Cotas e limites de indexação de frota](https://docs.aws.amazon.com/general/latest/gr/iot_device_management.html#fleet-indexing-limits).
Para outro método para obter informações sobre como coletar a distribuição da versão do pacote, consulte [Como coletar a distribuição da versão do pacote por meio de `getBucketsAggregation`](https://docs.aws.amazon.com/iot/latest/developerguide/preparing-fleet-indexing.html#package-version-distribution).
## Padrões de consulta
A indexação de frota com o Catálogo de pacotes de software usa a maioria dos atributos aceitos (por exemplo, termos, frases e campos de pesquisa). No entanto, operadores de comparação (por exemplo, menor que `<` e maior que `>`) e consultas `range` não estão disponíveis para a chave `version` de sombra reservada nomeada (`$package`). Essas consultas estão disponíveis para a chave `attributes`. Para obter mais informações, consulte [Sintaxe de consulta](https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html).
### Exemplo de dados
**Nota:** para obter informações sobre a sombra nomeada reservada e sua estrutura, consulte [Sombra nomeada reservada](https://docs.aws.amazon.com/iot/latest/developerguide/preparing-to-use-software-package-catalog.html#reserved-named-shadow).
Neste exemplo, um primeiro dispositivo é nomeado `AnyThing` e tem os seguintes pacotes instalados:
+ Pacote de software: `SamplePackage`
Versão do pacote: `1.0.0`
ID de pacote: `1111`
A sombra se parece com esta a seguir:
```
{
"state": {
"reported": {
"SamplePackage": {
"version": "1.0.0",
"attributes": {
"s3UrlForSamplePackage": "https://EXAMPIEBUCKET.s3.us-west-2.amazonaws.com/exampleCodeFile1",
"packageID": "1111"
}
}
}
}
}
```
Um segundo dispositivo tem um nome `AnotherThing` e tem o seguinte pacote instalado:
+ Pacote de software: `SamplePackage`
Versão do pacote: `1.0.0`
ID de pacote: `1111`
+ Pacote de software: `OtherPackage`
Versão do pacote: `1.2.5`
ID de pacote: `2222`
A sombra se parece com esta a seguir:
```
{
"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 exemplo
A tabela a seguir lista exemplos de consultas com base nos exemplos de sombras de dispositivos para `AnyThing` e `AnotherThing`. Para obter mais informações, consulte a opção [Consultas de exemplo do objeto](https://docs.aws.amazon.com/iot/latest/developerguide/example-queries.html).
**Versão mais recente do AWS IoT Device Tester for FreeRTOS**
| **Informações solicitadas** | **Consulta** | **Resultado** |
| --- | --- | --- |
| objetos que têm uma versão de pacote específica instalada | `shadow.name.$package.reported.SamplePackage.version:1.0.0` | `AnyThing`, `OtherThing` |
| objetos que não têm uma versão específica do pacote instalada | `NOT shadow.name.$package.reported.OtherPackage.version:1.2.5` | `AnyThing` |
| Qualquer dispositivo usando uma versão de pacote cujo ID do pacote seja maior que 1.500 | `shadow.name.$package.reported.*.attributes.packageID>1500"` | `OtherThing` |
| Objetos que têm um pacote específico instalado e com mais de um pacote instalado | `shadow.name.$package.reported.SamplePackage.version:1.0.0 AND shadow.name.$package.reported.totalCount:2` | `OtherThing` |
## Coleta da distribuição da versão do pacote por meio de `getBucketsAggregation`
Além do painel **Discovery** no AWS IoT console, você também pode obter informações sobre a distribuição da versão do pacote usando a operação da [https://docs.aws.amazon.com/iot/latest/apireference/API_GetBucketsAggregation.html](https://docs.aws.amazon.com/iot/latest/apireference/API_GetBucketsAggregation.html)API. Para obter as informações de distribuição da versão do pacote, você precisa fazer o seguinte:
+ Defina um campo personalizado na indexação da frota para cada pacote de software. **Nota:** Criação dos campos personalizados conta para [AWS IoT service quotas para indexação de frota](https://docs.aws.amazon.com/general/latest/gr/iot_device_management.html#fleet-indexing-limits).
+ Formate o campo personalizado da seguinte forma:
`shadow.name.$package.reported..version`
Para obter mais informações, consulte a seção [Campos personalizados](https://docs.aws.amazon.com/iot/latest/developerguide/managing-fleet-index.html#custom-field) na indexação de AWS IoT frotas.