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á.
# Configuração para dispositivos e frotas no SageMaker Edge Manager
Frotas são coleções de dispositivos agrupados logicamente que você pode usar para coletar e analisar dados. Você pode usar o SageMaker Edge Manager para operar modelos de aprendizado de máquina em uma frota de câmeras inteligentes, alto-falantes inteligentes, robôs e outros dispositivos de ponta.
Crie uma frota e registre seus dispositivos programaticamente com AWS SDK para Python (Boto3) ou por meio do console de SageMaker IA.
**Topics**
+ [Criar uma frota](edge-device-fleet-create.md)
+ [Registrar um dispositivo](edge-device-fleet-register.md)
+ [Verificar status](edge-device-fleet-check-status.md)
# Criar uma frota
[Você pode criar uma frota programaticamente com AWS SDK para Python (Boto3) ou por meio do console https://console.aws.amazon.com de SageMaker IA /sagemaker.](https://console.aws.amazon.com/sagemaker/)
## Criar uma frota (Boto3)
Use a `CreateDeviceFleet` API para criar uma frota. Especifique um nome para a frota, seu ARN de AWS IoT função para o `RoleArn` campo, bem como um URI do Amazon S3 em que você deseja que o dispositivo armazene dados de amostra.
Opcionalmente, você pode incluir uma descrição da frota, etiquetas e uma ID de AWS KMS chave.
```
import boto3
# Create SageMaker client so you can interact and manage SageMaker resources
sagemaker_client = boto3.client("sagemaker", region_name="aws-region")
sagemaker_client.create_device_fleet(
DeviceFleetName="sample-fleet-name",
RoleArn="arn:aws:iam::999999999:role/rolename", # IoT Role ARN
Description="fleet description",
OutputConfig={
S3OutputLocation="s3://bucket/",
KMSKeyId: "1234abcd-12ab-34cd-56ef-1234567890ab",
},
Tags=[
{
"Key": "string",
"Value" : "string"
}
],
)
```
Um alias de AWS IoT função é criado para você quando você cria uma frota de dispositivos. O alias da AWS IoT função fornece um mecanismo para que os dispositivos conectados se autenticem AWS IoT usando certificados X.509 e, em seguida, obtenham AWS credenciais de curta duração de uma função do IAM associada ao alias da função. AWS IoT
Use `DescribeDeviceFleet` para obter o nome do alias da função e o ARN.
```
# Print Amazon Resource Name (ARN) and alias that has access
# to AWS Internet of Things (IoT).
sagemaker_client.describe_device_fleet(DeviceFleetName=device_fleet_name)['IotRoleAlias']
```
Use a API `DescribeDeviceFleet` para obter uma descrição das frotas criadas por você.
```
sagemaker_client.describe_device_fleet(
DeviceFleetName="sample-fleet-name"
)
```
Por padrão, ele retorna o nome da frota, o ARN da frota de dispositivos, o URI do bucket do Amazon S3, a função do IAM, o alias da função criado AWS IoT em, um timestamp de quando a frota foi criada e um timestamp de quando a frota foi modificada pela última vez.
```
{ "DeviceFleetName": "sample-fleet-name",
"DeviceFleetArn": "arn:aws:sagemaker:us-west-2:9999999999:device-fleet/sample-fleet-name",
"IAMRole": "arn:aws:iam::999999999:role/rolename",
"Description": "this is a sample fleet",
"IoTRoleAlias": "arn:aws:iot:us-west-2:9999999999:rolealias/SagemakerEdge-sample-fleet-name"
"OutputConfig": {
"S3OutputLocation": "s3://bucket/folder",
"KMSKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab"
},
"CreationTime": "1600977370",
"LastModifiedTime": "1600977370"}
```
## Criar uma frota (console)
Você pode criar um trabalho de empacotamento do Edge Manager usando o console Amazon SageMaker AI em [https://console.aws.amazon.com/sagemaker](https://console.aws.amazon.com/sagemaker/).
1. No console SageMaker AI, escolha **Edge Manager** e, em seguida, escolha **Frotas de dispositivos Edge**.
1. Escolha **Criar frota de dispositivos**.
![\[A localização de Criar frota de dispositivos no console.\]](http://docs.aws.amazon.com/pt_br/sagemaker/latest/dg/images/smith/create-device-button-edited.png)
1. Insira um nome para a frota de dispositivos no campo **Nome da frota de dispositivos**. Escolha **Próximo**.
![\[A localização do botão Próximo na seção Propriedades da frota de dispositivos no console.\]](http://docs.aws.amazon.com/pt_br/sagemaker/latest/dg/images/smith/create-device-fleet-filled.png)
1. Na página de **configuração de saída**, especifique o URI do bucket do Amazon S3 em que você deseja armazenar dados de amostra da sua frota de dispositivos. Opcionalmente, você também pode adicionar uma chave de criptografia selecionando uma AWS KMS chave existente na lista suspensa ou inserindo o ARN de uma chave. Selecione **Enviar**.
![\[Exemplo da página Configuração de saída no console:\]](http://docs.aws.amazon.com/pt_br/sagemaker/latest/dg/images/smith/create-device-fleet-output-filled.png)
1. Escolha o nome da sua frota de dispositivos para ser redirecionado aos detalhes da frota de dispositivos. Esta página exibe o nome da frota de dispositivos, ARN, descrição (se você forneceu uma), data em que a frota foi criada, última vez que a frota foi modificada, URI do bucket do Amazon S3, AWS KMS ID da chave (se fornecido), AWS IoT alias (se fornecido) e perfil do IAM. Se você adicionou etiquetas, elas aparecem na seção **Tags de frota de dispositivos**.
# Registrar um dispositivo
**Importante**
O registro do dispositivo é necessário para usar qualquer parte do SageMaker Edge Manager.
[Você pode criar uma frota programaticamente com AWS SDK para Python (Boto3) ou por meio do console de SageMaker IA em https://console.aws.amazon.com /sagemaker.](https://console.aws.amazon.com/sagemaker/)
## Registrar um dispositivo (Boto3)
Para registrar seu dispositivo, primeiro crie e registre um AWS IoT objeto e configure uma função do IAM. SageMaker O Edge Manager aproveita os AWS IoT Core serviços para facilitar a conexão entre os dispositivos de borda e a nuvem. Você pode aproveitar a AWS IoT funcionalidade existente depois de configurar seus dispositivos para trabalhar com o Edge Manager.
Para conectar seu dispositivo a AWS IoT você precisa criar objetos AWS IoT , criar e registrar um certificado de cliente e criar e configurar a função do IAM para seus dispositivos. AWS IoT
Consulte o [Guia de introdução](https://docs.aws.amazon.com/sagemaker/latest/dg/edge-manager-getting-started.html) para ver um exemplo detalhado ou o tutorial prático [Explore os serviços do AWS IoT Core](https://docs.aws.amazon.com/iot/latest/developerguide/iot-gs-first-thing.html).
Use a API `RegisterDevices` para registrar seu dispositivo. Forneça o nome da frota da qual você deseja que os dispositivos façam parte, bem como um nome para o dispositivo. Opcionalmente, você pode adicionar uma descrição ao dispositivo, às tags e ao nome do AWS IoT item associado ao dispositivo.
```
sagemaker_client.register_devices(
DeviceFleetName="sample-fleet-name",
Devices=[
{
"DeviceName": "sample-device-1",
"IotThingName": "sample-thing-name-1",
"Description": "Device #1"
}
],
Tags=[
{
"Key": "string",
"Value" : "string"
}
],
)
```
## Registrar um dispositivo (console)
Você pode registrar seu dispositivo usando o console de SageMaker IA em [https://console.aws.amazon.com/sagemaker](https://console.aws.amazon.com/sagemaker/).
1. No console SageMaker AI, escolha **Edge Inference** e, em seguida, escolha **Edge devices**.
1. Escolha **Registrar dispositivo**.
![\[Localização de Registrar dispositivos na seção Dispositivos de borda do console.\]](http://docs.aws.amazon.com/pt_br/sagemaker/latest/dg/images/smith/register-device-button.png)
1. Na seção **Propriedades do dispositivo**, insira o nome da frota à qual o dispositivo pertence no campo **Nome da frota do dispositivo**. Escolha **Próximo**.
![\[A seção Propriedades do dispositivo no console.\]](http://docs.aws.amazon.com/pt_br/sagemaker/latest/dg/images/smith/register-devices-empty.png)
1. Na seção **Origem do dispositivo**, adicione seus dispositivos um por um. Você deve incluir um **nome de dispositivo** para cada dispositivo em sua frota. Opcionalmente, você pode fornecer uma descrição (no campo **Descrição**) e um nome de objeto da Internet das Coisas (IoT) (no campo **Nome da IoT**). Escolha **Enviar** depois de adicionar todos os seus dispositivos.
![\[A seção Origem do dispositivo no console.\]](http://docs.aws.amazon.com/pt_br/sagemaker/latest/dg/images/smith/register-devices-device-source.png)
A página **Dispositivos** exibe o nome do dispositivo que você adicionou, a frota à qual ele pertence, quando foi registrado, a última pulsação e a descrição e o AWS IoT nome, se você tiver fornecido um.
Escolha um dispositivo para ver os detalhes do dispositivo, incluindo nome do dispositivo, frota, ARN, descrição, nome de Coisas de IoT, quando o dispositivo foi registrado e a última pulsação.
# Verificar status
Verifique se o seu dispositivo ou frota está conectado e coletando dados. Fazer verificações periódicas, manual ou automaticamente, permite que você verifique se seu dispositivo ou frota está funcionando corretamente.
Use o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)para escolher interativamente uma frota para uma verificação de status. Você também pode usar o AWS SDK para Python (Boto3) Veja a seguir uma descrição APIs diferente do Boto3 que você pode usar para verificar o status do seu dispositivo ou frota. Use a API que melhor se adapta ao seu caso de uso.
+ **Verifique um dispositivo individual.**
Para verificar o status de um dispositivo individual, use a API `DescribeDevice`. Uma lista contendo um ou mais modelos é fornecida se um modelo tiver sido implantado no dispositivo.
```
sagemaker_client.describe_device(
DeviceName="sample-device-1",
DeviceFleetName="sample-fleet-name"
)
```
Executando as devoluções `DescribeDevice`:
```
{ "DeviceName": "sample-device".
"Description": "this is a sample device",
"DeviceFleetName": "sample-device-fleet",
"IoTThingName": "SampleThing",
"RegistrationTime": 1600977370,
"LatestHeartbeat": 1600977370,
"Models":[
{
"ModelName": "sample-model",
"ModelVersion": "1.1",
"LatestSampleTime": 1600977370,
"LatestInference": 1600977370
}
]
}
```
+ **Verifique uma frota de dispositivos.**
Para checar o status da frota, use a API `GetDeviceFleetReport`. Forneça o nome da frota de dispositivos para obter um resumo da frota.
```
sagemaker_client.get_device_fleet_report(
DeviceFleetName="sample-fleet-name"
)
```
+ **Verifique se há pulsação.**
Cada dispositivo dentro de uma frota gera periodicamente um sinal, ou “pulsação”. A pulsação pode ser usada para verificar se o dispositivo está se comunicando com o Edge Manager. Se o timestamp da última pulsação não estiver sendo atualizado, o dispositivo pode estar falhando.
Verifique a última pulsação feita por um dispositivo com a `DescribeDevice` API. Especifique o nome do dispositivo e a frota à qual o dispositivo de borda pertence.
```
sagemaker_client.describe_device(
DeviceName="sample-device-1",
DeviceFleetName="sample-fleet-name"
)
```