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á.
# Entenda os dados de telemetria
Os dados de telemetria são entregues como registros JSON codificados em Base64 para seu stream do Kinesis Data Streams. Cada registro contém informações coletadas durante seu contato via satélite, incluindo metadados sobre o contato e as medições de telemetria amostradas.
## Visão geral do formato de dados
Cada registro de telemetria contém os seguintes componentes:
Tipo e versão da telemetria
Identifica o tipo específico de dados de telemetria e sua versão do esquema. Isso permite que você analise diferentes tipos de telemetria de forma adequada. Para obter mais informações sobre o controle de versão do esquema, consulte. [Controle de versão e evolução do esquema](#telemetry.understanding-data.schema-evolution)
ID do escopo
Um identificador exclusivo para o escopo da telemetria. Isso permite que você correlacione dados de telemetria com contatos específicos.
Metadados
Informações contextuais sobre a telemetria.
Dados
As medidas de telemetria amostradas específicas para o tipo de telemetria.
**Chave de partição**
Os registros de telemetria são entregues ao seu stream do Kinesis Data Streams com uma chave de partição no formato:
```
SCOPE#scopeId#TELEMETRY_ID#telemetryId#TELEMETRY_VERSION#telemetryVersion
```
Essa chave de partição garante que toda a telemetria de um determinado tipo para um único contato seja entregue ao mesmo fragmento em seu stream do Kinesis Data Streams, oferecendo a melhor ordenação de esforços para o stream de telemetria desse contato.
## Telemetria apontadora
A telemetria de apontamento fornece informações sobre a direção do apontamento da antena durante os contatos do satélite. Esse tipo de telemetria é sempre enviado durante um contato.
**Campos de dados**
Carimbo de data/hora da amostra
Hora em que os dados de telemetria foram amostrados, no formato ISO-8601 em UTC com precisão de milissegundos.
azimute
Ângulo de azimute real da antena em graus.
elevação
Ângulo de elevação real da antena em graus.
Comandou Azimuth
Ângulo de azimute comandado em graus. Esse é o ângulo de azimute alvo que a antena está tentando alcançar.
Elevação comandada
Ângulo de elevação comandado em graus. Esse é o ângulo de elevação alvo que a antena está tentando alcançar.
**nota**
A posição real da antena pode ser diferente da posição comandada devido a limitações físicas ou atrasos mecânicos durante o contato.
**Campos de metadados**
Estação Terrestre
Nome da estação terrestre (por exemplo, “Ohio 1").
ID de satélite
Identificador do recurso de satélite em AWS Ground Station.
contactId
Identificador do contato.
**Exemplo de JSON**
```
{
"telemetryTypeAndVersion": "POINTING#1.0.0",
"telemetryType": "POINTING",
"telemetryVersion": "1.0.0",
"scopeId": "12345678-1234-1234-1234-123456789012",
"metadata": {
"groundStation": "Ohio 1",
"satelliteId": "87654321-4321-4321-4321-210987654321",
"contactId": "12345678-1234-1234-1234-123456789012"
},
"data": {
"sampleTimestamp": "2025-12-08T12:00:00.123Z",
"azimuth": 180.5,
"elevation": 45.2,
"commandedAzimuth": 180.0,
"commandedElevation": 45.0
}
}
```
## Telemetria de rastreamento
A telemetria de rastreamento fornece informações sobre o status de rastreamento da antena e os erros de rastreamento. Esse tipo de telemetria é enviado quando o rastreamento automático está ativado em sua configuração de rastreamento e quando a antena está usando ativamente o rastreamento automático.
**nota**
Se o `autotrack` parâmetro em seu TrackingConfig estiver definido como`REMOVED`, nenhuma telemetria de rastreamento será fornecida. Para obter mais informações sobre configurações de rastreamento, consulte[Configuração de rastreamento](how-it-works.config.md#how-it-works.config-tracking).
**Campos de dados**
Carimbo de data/hora da amostra
Hora em que os dados de telemetria foram amostrados, no formato ISO-8601 em UTC com precisão de milissegundos.
Status de rastreamento
Status atual de rastreamento da antena. Os valores possíveis incluem `TRACKING`, `ACQUIRING` e `MASKED`.
trackingErrorAzimuth
Erro de rastreamento no eixo do azimute, medido em graus.
trackingErrorElevation
Erro de rastreamento no eixo de elevação, medido em graus.
**nota**
Os valores de erro de rastreamento representam ajustes da trilha do programa baseada em efemérides que AWS Ground Station se aplica durante o rastreamento automático para maximizar a intensidade do sinal.
**Campos de metadados**
A telemetria de rastreamento inclui os mesmos campos de metadados da telemetria apontadora:,, e. `groundStation` `satelliteId` `contactId`
**Exemplo de JSON**
```
{
"telemetryTypeAndVersion": "TRACKING#1.0.0",
"telemetryType": "TRACKING",
"telemetryVersion": "1.0.0",
"scopeId": "12345678-1234-1234-1234-123456789012",
"metadata": {
"groundStation": "Ohio 1",
"satelliteId": "87654321-4321-4321-4321-210987654321",
"contactId": "12345678-1234-1234-1234-123456789012"
},
"data": {
"sampleTimestamp": "2025-12-08T12:00:00.123Z",
"trackingStatus": "TRACKING",
"trackingErrorAzimuth": 0.2,
"trackingErrorElevation": 0.1
}
}
```
## Lendo dados do stream do Kinesis Data Streams
Os dados de telemetria são entregues ao seu stream do Kinesis Data Streams e podem ser consumidos usando padrões de consumo de stream padrão. Ao ler os dados do seu stream, tenha em mente as seguintes considerações.
**Decodificação Base64**
Os dados no stream do Kinesis Data Streams são codificados em Base64. Você deve decodificar os dados antes de analisá-los como JSON. Para obter mais informações, consulte Como [trabalhar com o Amazon Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/working-with-streams.html).
**Usando o Kinesis Data Viewer**
Para acesso rápido aos seus dados de telemetria, o console de stream do Kinesis Data Streams oferece um recurso Visualizador de dados. Ao usar esse recurso:
+ A entrega de telemetria pode ocorrer em qualquer fragmento em seu stream.
+ A posição inicial padrão é a dos registros mais recentes no fragmento.
+ Talvez seja necessário ajustar o fragmento selecionado e usar a posição inicial “No timestamp” para visualizar os registros recebidos.
**Usando a biblioteca de cliente Kinesis**
A Kinesis Client Library (KCL) gerencia muitas das complexidades associadas ao consumo de dados do stream do Kinesis Data Streams, incluindo gerenciamento de fragmentos, pontos de verificação e balanceamento de carga. Recomendamos o uso do KCL para aplicativos de consumo de telemetria de produção.
Para obter mais informações, consulte [Desenvolvendo consumidores usando a biblioteca cliente Kinesis](https://docs.aws.amazon.com/streams/latest/dev/kcl.html).
**Melhores práticas de consumo**
+ **Minimize a latência** — Use o Enhanced Fan-Out para ler o stream do Kinesis Data Streams com taxa de transferência dedicada e menor latência em comparação com a pesquisa. Para obter mais informações, consulte [Desenvolvendo consumidores avançados de fan-out.](https://docs.aws.amazon.com/streams/latest/dev/enhanced-consumers.html)
+ **Stream dedicado — Use um stream** dedicado do Kinesis Data Streams AWS Ground Station para sua integração de telemetria. Compartilhar um stream com outros aplicativos pode causar saturação da taxa de transferência de gravação e falhas na entrega de telemetria.
+ **Capacidade sob demanda** — implante seu stream do Kinesis Data Streams no modo de provisionamento sob demanda para permitir o escalonamento automático de fragmentos com base na taxa de transferência.
+ **Monitore a taxa de transferência** - monitore a limitação do fluxo usando métricas. 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).
## Controle de versão e evolução do esquema
Os esquemas de telemetria são versionados para apoiar a evolução ao longo do tempo. O `telemetryVersion` campo em cada registro indica a versão do esquema.
**Lidando com alterações no esquema**
+ Novos tipos de telemetria podem ser introduzidos no futuro.
+ Os tipos de telemetria existentes podem receber novas versões com alterações significativas.
+ Seus aplicativos devem tolerar tipos e versões de telemetria desconhecidos.
+ Analise os `telemetryVersion` campos `telemetryTypeAndVersion``telemetryType`, e para determinar como processar cada registro.
Recomendamos implementar a serialização de carga útil com reconhecimento de versão que possa lidar com várias versões do esquema normalmente, permitindo que seus aplicativos continuem funcionando quando novas versões forem introduzidas.