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:

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

Campos de metadados

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.

Campos de dados

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.

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:

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.

Melhores práticas de consumo

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

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.