Tutorial de inicialização

Execute o seguinte comando para ativar a indexação de frotas e especificar as fontes de dados a partir das quais pesquisar.

aws iot update-indexing-configuration \
--thing-indexing-configuration "thingIndexingMode=REGISTRY_AND_SHADOW,customFields=[{name=attributes.temperature,type=Number},{name=attributes.rackId,type=String},{name=attributes.stateNormal,type=Boolean}],thingConnectivityIndexingMode=STATUS" \

O exemplo de comando da CLI anterior permite que a indexação de frotas ofereça suporte à pesquisa de dados de registro, dados de sombra e status de conectividade de objetos usando o índice AWS_Things.

Pode levar alguns minutos para que a alteração de configuração seja concluída. Antes de criar métricas de frota, verifique se a indexação da frota está ativada.

Execute o seguinte comando da CLI para verificar se a indexação da frota foi ativada:

aws --region us-east-1 iot describe-index --index-name "AWS_Things"

Para obter mais informações, consulte Habilitar a indexação de itens.

Execute o script bash a seguir para criar dez objetos e descrevê-las.

# Bash script. Type `bash` before running in other shells.

Temperatures=(70 71 72 73 74 75 47 97 98 99)
Racks=(Rack1 Rack1 Rack2 Rack2 Rack3 Rack4 Rack5 Rack6 Rack6 Rack6)
IsNormal=(true true true true true true false false false false)

for ((i=0; i < 10; i++))
do
  thing=$(aws iot create-thing --thing-name "TempSensor$i" --attribute-payload attributes="{temperature=${Temperatures[@]:$i:1},rackId=${Racks[@]:$i:1},stateNormal=${IsNormal[@]:$i:1}}")
  aws iot describe-thing --thing-name "TempSensor$i"
done

O script cria dez objetos para representar dez sensores. Cada objeto tem atributos de temperature, rackId e stateNormal, conforme descrito na seguinte tabela:

A saída desse script contém dez arquivos JSON. Um dos arquivos JSON tem a seguinte aparência:

{
    "version": 1, 
    "thingName": "TempSensor0", 
    "defaultClientId": "TempSensor0", 
    "attributes": {
        "rackId": "Rack1", 
        "stateNormal": "true", 
        "temperature": "70"
    }, 
    "thingArn": "arn:aws:iot:region:account:thing/TempSensor0", 
    "thingId": "example-thing-id"
}

Para obter mais informações, consulte Criar um objeto.

Execute o comando a seguir para criar uma métrica de frota nomeada high_temp_FM. A métrica da frota é criada para monitorar o número de sensores com temperaturas que excedem 80 graus Fahrenheit no CloudWatch.

aws iot create-fleet-metric --metric-name "high_temp_FM" --query-string "thingName:TempSensor* AND attributes.temperature >80" --period 60 --aggregation-field "attributes.temperature" --aggregation-type name=Statistics,values=count

--metric-name

Tipo de dados: string. O parâmetro --metric-name especifica o nome da métrica da frota. Neste exemplo, você está criando uma métrica de frota chamada high_temp_FM.

--query-string

Tipo de dados: string. O parâmetro --query-string especifica a string de consulta. Neste exemplo, a string de consulta indica que se consulte todas as objetos cujos nomes começam com TempSensor e com temperaturas superiores a 80 graus Fahrenheit. Para obter mais informações, consulte Sintaxe de consulta.

--period

Tipo de dados: inteiro. O parâmetro --period especifica o tempo, em segundos, até a recuperação dos dados agregados. Neste exemplo, está especificado que a métrica de frota criada por você recupera os dados agregados a cada 60 segundos.

--aggregation-field

Tipo de dados: string. O parâmetro --aggregation-field especifica o atributo a ser avaliado. Neste exemplo, o atributo a ser avaliado é a temperatura.

--aggregation-type

O parâmetro --aggregation-type especifica o resumo estatístico a ser exibido na métrica da frota. Para tarefas de monitoramento, é possível personalizar as propriedades das consultas de agregação conforme os diferentes tipos de agregação (estatística, cardinalidade e percentual). Neste exemplo, especifica-se contagem como tipo de agregação e Estatísticas para retorno da contagem de dispositivos que têm atributos correspondentes à consulta. Em outras palavras, para retornar a contagem dos dispositivos com nomes que comecem com TempSensor e com temperaturas maiores que 80 graus Fahrenheit. Para obter mais informações, consulte Consultar dados agregados.

A saída desse comando é semelhante à seguinte:

{
    "metricArn": "arn:aws:iot:region:111122223333:fleetmetric/high_temp_FM", 
    "metricName": "high_temp_FM"
}

Para saber mais sobre a criação de uma métrica de frota, leia Gerenciar métricas de frota.

Se você não conseguir criar uma métrica de frota, leia Solução de problemas de métricas de frota.

(Opcional) Execute o seguinte comando para descrever uma métrica de frota nomeada high_temp_FM:

aws iot describe-fleet-metric --metric-name "high_temp_FM"

A saída desse comando é semelhante à seguinte:

{
    "queryVersion": "2017-09-30", 
    "lastModifiedDate": 1625249775.834, 
    "queryString": "*", 
    "period": 60, 
    "metricArn": "arn:aws:iot:region:111122223333:fleetmetric/high_temp_FM", 
    "aggregationField": "registry.version", 
    "version": 1, 
    "aggregationType": {
        "values": [
            "count"
        ], 
        "name": "Statistics"
    }, 
    "indexName": "AWS_Things", 
    "creationDate": 1625249775.834, 
    "metricName": "high_temp_FM"
}

Abra o console do CloudWatch em https://console.aws.amazon.com/cloudwatch/.

No menu do CloudWatch no painel esquerdo, selecione Métricas para expandir o submenu e, depois, selecione Todas as métricas. Isso abrirá a página com uma metade superior para exibir o gráfico e uma metade inferior que contém quatro seções com guias.

A primeira seção com guia, Todas as métricas, lista todas as métricas que você pode visualizar em grupos. Selecione IotFleetMetrics. Aqui estão todas as métricas da sua frota.

Na seção Tipo de agregação da guia Todas as métricas, selecione Tipo de agregação para visualizar todas as métricas de frota criadas por você.

Selecione a métrica da frota para exibir o gráfico à esquerda da seção Tipo de agregação. Você verá a contagem de valores à esquerda do Nome da métrica, e esse é o valor do tipo de agregação especificado na seção Criação de métricas de frota deste tutorial.

Escolha a segunda guia, chamada Métricas gráficas, à direita da guia Todas as métricas, para ver a métrica da frota que você escolheu na etapa anterior.

Você deve conseguir ver um gráfico exibindo o número de sensores com temperaturas maiores que 80 graus Fahrenheit, como este:

(Opcional) É possível definir um alarme métrico.