Record - Amazon Timestream

Para recursos semelhantes aos do Amazon Timestream para LiveAnalytics, considere o Amazon Timestream para InfluxDB. Ele oferece ingestão de dados simplificada e tempos de resposta de consulta de um dígito em milissegundos para análises em tempo real. Saiba mais aqui.

Record

Representa um ponto de dados de séries temporais sendo gravado no Timestream. Cada registro contém uma matriz de dimensões. As dimensões representam os atributos de metadados de um ponto de dados de série temporal, como o nome da instância ou a zona de disponibilidade de uma instância do EC2. Um registro também contém o nome da medida, que é o nome da medida que está sendo coletada (por exemplo, a utilização da CPU de uma instância do EC2). Além disso, um registro contém o valor da medida e o tipo de valor, que é o tipo de dados do valor da medida. Além disso, o registro contém o registro de data e hora de quando a medida foi coletada e a unidade de registro de data e hora, que representa a granularidade do timestamp.

Os registros têm um campo Version, que é um long de 64 bits que você pode usar para atualizar pontos de dados. As gravações de um registro duplicado com a mesma dimensão, data e hora e nome de medida, mas com valores de medida diferentes, só serão bem-sucedidas se o atributo Version do registro na solicitação de gravação for maior que o do registro existente. O padrão do Timestream é Version de 1 para registros sem o campo Version.

Conteúdo

Dimensions

Contém a lista de dimensões para pontos de dados de séries temporais.

Tipo: matriz de objetos Dimension

Membros da matriz: número máximo de 128 itens.

Obrigatório: Não

MeasureName

A medida representa o atributo de dados da série temporal. Por exemplo, a utilização da CPU de uma instância do EC2 ou a RPM de uma turbina eólica são medidas.

Tipo: String

Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 256.

Obrigatório: Não

MeasureValue

Contém o valor da medida para o ponto de dados de série temporal.

Tipo: String

Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 2.048.

Obrigatório: Não

MeasureValues

Contém a lista de MeasureValue para dados de séries temporais.

Isso só é permitido para o tipo MULTI. Para valores escalares, use o atributo MeasureValue do registro diretamente.

Tipo: matriz de objetos MeasureValue

Obrigatório: Não

MeasureValueType

Contém o tipo de dados do valor da medida para o ponto de dados de série temporal. O tipo padrão é DOUBLE. Para obter mais informações, consulte Tipos de dados.

Tipo: String

Valores Válidos: DOUBLE | BIGINT | VARCHAR | BOOLEAN | TIMESTAMP | MULTI

Obrigatório: Não

Time

Contém a hora em que o valor da medida para o ponto de dados foi coletado. O valor do tempo mais a unidade fornece o tempo decorrido desde a época. Por exemplo, se o valor do tempo for 12345 e a unidade for ms, então 12345 ms já passaram desde a época.

Tipo: String

Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 256.

Obrigatório: Não

TimeUnit

A granularidade da unidade de registro de data e hora. Indica se o valor do tempo está em segundos, milissegundos, nanossegundos ou outros valores compatíveis. O padrão é MILLISECONDS.

Tipo: String

Valores Válidos: MILLISECONDS | SECONDS | MICROSECONDS | NANOSECONDS

Obrigatório: Não

Version

Atributo de 64 bits usado para atualizações de registros. As solicitações de gravação de dados duplicados com um número de versão maior atualizarão o valor e a versão existentes da medida. Nos casos em que o valor da medida for o mesmo, Version ainda será atualizado. O valor padrão é . 1.

nota

Version deve ser 1 ou maior, ou você receberá um erro ValidationException.

Tipo: longo

Obrigatório: Não

Consulte também

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte: