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á.
# Configurar a telemetria
Siga estas etapas para configurar a telemetria para seus AWS Ground Station contatos. Depois de concluir essa configuração, os dados de telemetria serão entregues ao seu stream do Kinesis Data Streams durante os contatos que usam um perfil de missão habilitado para telemetria. Para uma compreensão aprofundada do Kinesis Data Streams, consulte o Guia do usuário do Kinesis [Data Streams](https://docs.aws.amazon.com/streams/latest/dev/introduction.html).
## Etapa 1: criar recursos de pré-requisitos AWS
O CloudFormation trecho a seguir demonstra como criar os recursos necessários para a entrega de AWS telemetria. Esse trecho cria um stream do Kinesis Data Streams e uma função do IAM que AWS Ground Station concede permissão para gravar dados de telemetria no stream.
```
TelemetryStream:
Type: AWS::Kinesis::Stream
Properties:
Name: GroundStationTelemetryStream
StreamModeDetails:
StreamMode: ON_DEMAND
RetentionPeriodHours: 24
TelemetryRole:
Type: AWS::IAM::Role
Properties:
RoleName: GroundStationTelemetryRole
AssumeRolePolicyDocument:
Version: '2012-10-17'
Statement:
- Effect: Allow
Principal:
Service: groundstation.amazonaws.com
Action: sts:AssumeRole
Policies:
- PolicyName: KinesisWritePolicy
PolicyDocument:
Version: '2012-10-17'
Statement:
- Effect: Allow
Action:
- kinesis:DescribeStream
- kinesis:PutRecord
- kinesis:PutRecords
Resource: !GetAtt TelemetryStream.Arn
```
A lista abaixo destaca considerações de configuração exclusivas ao configurar a entrega de telemetria para. AWS Ground Station
Stream do **Kinesis Data** Streams — O stream usa o modo de capacidade sob demanda, que é escalado automaticamente com base na taxa de transferência. Isso é recomendado para a maioria dos casos de uso. O stream está configurado para reter dados por 24 horas. Por padrão, o stream usa criptografia AWS gerenciada. Para usar a criptografia gerenciada pelo cliente AWS Key Management Service, adicione a `StreamEncryption` propriedade e atualize a política de função do IAM para incluir `kms:GenerateDataKey` a permissão. Para obter mais informações, consulte [Proteção de dados no Amazon Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/server-side-encryption.html).
**Função do IAM** - A função do IAM permite que o diretor do `groundstation.amazonaws.com` serviço assuma a função e grave dados de telemetria no seu stream do Kinesis Data Streams. A política de função concede permissões para `kinesis:DescribeStream``kinesis:PutRecord`, e `kinesis:PutRecords` ações no stream. Consulte [Configuração do coletor de telemetria](how-it-works.config.md#how-it-works.config-telemetry-sink) para obter orientação sobre como configurar a política de confiança e a política de funções.
**Configuração adicional**: adicione `iam:PassRole` permissões ao usuário ou à função do IAM que você usa para chamadas de AWS Ground Station API. Isso permite que você passe a função de telemetria para AWS Ground Station ao criar um. TelemetrySinkConfig
### Exemplo PassRole de política
Para obter mais informações sobre como atualizar ou anexar uma política de função, consulte [Gerenciamento de políticas do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage.html) no Guia do usuário do IAM. Para obter mais informações sobre a `iam:PassRole` permissão, consulte [Conceder permissões a um usuário para passar uma função para um serviço da AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_passrole.html)
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"iam:GetRole",
"iam:PassRole"
],
"Resource": "arn:aws:iam::999999999999:role/your-telemetry-delivery-role-name"
}
]
}
```
## Etapa 2: criar um TelemetrySinkConfig
Crie um *TelemetrySinkConfig*que defina como AWS Ground Station entregará dados de telemetria ao seu stream do Kinesis Data Streams. Use o ARN do stream e o ARN da função das saídas da CloudFormation pilha na Etapa 1.
**nota**
Ao criar um *TelemetrySinkConfig*, AWS Ground Station verificará o acesso ao seu stream do Kinesis Data Streams entregando um registro de teste vazio com uma chave de partição de. `test`
Para obter mais informações sobre a criação de um *TelemetrySinkConfig*, consulte[Configuração do coletor de telemetria](how-it-works.config.md#how-it-works.config-telemetry-sink).
## Etapa 3: adicionar telemetria ao seu perfil de missão
Crie um perfil de missão. Para obter mais informações sobre a criação de perfis de missão, consulte[Use perfis de AWS Ground Station missão](how-it-works-mission-profile.md). Adicione o `telemetrySinkConfigArn` ao seu perfil de missão para permitir a entrega de telemetria durante os contatos. Use o ARN do *TelemetrySinkConfig*criado na Etapa 2.
## Etapa 4: agendar um contato
Agende um contato usando seu perfil de missão habilitado para telemetria. Durante o contato, AWS Ground Station transmitirá dados de telemetria para seu stream do Kinesis Data Streams.
**O que esperar durante os contatos**
+ Início da **telemetria - Os dados começam** a ser transmitidos quando o contato é iniciado.
+ **Entrega quase em tempo real** — a telemetria chega ao seu stream do Kinesis Data Streams quase em tempo real.
+ **Duração do contato** - Os dados continuam durante todo o contato.
+ **Parada automática** - A telemetria interrompe a transmissão quando o contato termina.
**Monitorando a entrega**
Você pode monitorar a entrega de telemetria usando:
+ Métricas de stream do **Kinesis Data Streams** - Verifique os registros recebidos. CloudWatch Para obter mais informações, consulte [Monitoramento do Amazon Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/monitoring-with-cloudwatch.html).
+ **Registros do aplicativo** - verifique o processamento de dados em seus aplicativos que consomem do stream.
+ **Kinesis Data Viewer** — use o console de stream do Kinesis Data Streams para ver exemplos de registros do seu stream.
## Próximas etapas
Depois de concluir a configuração, você pode:
+ Saiba mais sobre o formato dos dados de telemetria e os tipos de telemetria disponíveis. Consulte [Entenda os dados de telemetria](telemetry.understanding-data.md).
+ Crie aplicativos para processar dados de telemetria do seu stream do Kinesis Data Streams. Para obter mais informações, consulte [Criação de consumidores para o Amazon Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/building-consumers.html).
+ Crie painéis e alertas usando CloudWatch outros AWS serviços.
+ Revise as orientações de solução de problemas se você encontrar problemas. Consulte [Solucionar problemas de telemetria](troubleshooting-telemetry.md).