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 de coisas dinâmicas. 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_sensor). Para obter mais informações, consulte Indexação de frota.

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 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.

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.

Métricas serão exibidos no console

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.

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.

Padrões de consulta

A indexação de frota com o Catálogo de pacotes de software usa a maioria dos atributos suportados (por exemplo, termos e frases e campos de pesquisa) que são padrão para indexação de frota. A exceção é que as consultas comparison e range não estão disponíveis para a chave ($package) version da sombra nomeada reservada. No entanto, essas consultas estão disponíveis para a chave attributes. Para obter mais informações, consulte Sintaxe de consulta.

Exemplo de dados

Nota: para obter informações sobre a sombra nomeada reservada e sua estrutura, consulte Sombra nomeada reservada.

Neste exemplo, um primeiro dispositivo é nomeado AnyThing e tem os seguintes pacotes instalados:

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:

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.

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 GetBucketsAggregationAPIoperação. Para obter as informações de distribuição da versão do pacote, você precisa fazer o seguinte:

Para obter mais informações, consulte a seção Campos personalizados na indexação de AWS IoT frotas.