Conectando-se a uma instância de banco de dados Amazon Timestream para InfluxDB - Amazon Timestream

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á.

Conectando-se a uma instância de banco de dados Amazon Timestream para InfluxDB

Antes de se conectar a uma instância de banco de dados, você deve criar a instância de banco de dados. Para obter mais informações, consulte Criar uma instância de banco de dados. Depois que o Amazon Timestream provisionar sua instância de banco de dados, use o API InfluxDB, o CLI Influx ou qualquer cliente ou utilitário compatível com o InfluxDB para se conectar à instância de banco de dados.

Encontrando as informações de conexão para uma instância de banco de dados Amazon Timestream for InfluxDB

As informações de conexão de uma instância de banco de dados incluem seu endpoint, porta, nome de usuário, senha e um token de acesso válido, como o operador ou todo o token de acesso. Por exemplo, para uma instância de banco de dados InfluxDB, suponha que o valor do endpoint seja. influxdb1-123456789.us-east-1.timestream-influxdb.amazonaws.com Nesse caso, o valor da porta é 8086 e o usuário do banco de dados é admin. Com essas informações, você especifica os seguintes valores em uma string de conexão:

  • Para host ou nome ou DNS nome do host, especifiqueinfluxdb1-123456789.us-east-1.timestream-influxdb.amazonaws.com.

  • Para porta, especifique 8086.

  • Para usuário, especifique admin.

  • Para senha, especifique aquela que você forneceu ao criar sua instância de banco de dados.

Importante

Quando você criou sua instância Timestream for InfluxDB Db, parte do objeto de DBInstance resposta você recebe uma. influxAuthParametersSecretArn Isso manterá um SecretsManager segredo em sua conta. Ele só será preenchido depois que suas instâncias de banco de dados InfluxDB estiverem disponíveis. O segredo contém parâmetros de autenticação de influxo fornecidos durante o CreateDbInstance processo. Essa é uma READONLY cópia, pois qualquer outra updates/modifications/deletions desse segredo não afeta a instância de banco de dados criada. Se você excluir esse segredo, nossa API resposta ainda se referirá ao aviso secreto excluído.

O endpoint é exclusivo para cada instância de banco de dados e os valores da porta e do usuário podem variar. Para se conectar a uma instância de banco de dados, você pode usar o InfluxCLI, o Influx API ou qualquer outro cliente compatível com o InfluxDB.

Para encontrar as informações de conexão de uma instância de banco de dados, use o AWS Management Console. Você também pode usar o AWS comando Command Line Interface (AWS CLI) ou a describe-db-instances operação API GetDBInstance Timestream-InfluxDB.

Usando o AWS Management Console
  1. Faça login AWS Management Console e abra o console do Amazon Timestream.

  2. No painel de navegação, escolha Bancos de dados InfluxDB para exibir uma lista de suas instâncias de banco de dados.

  3. Escolha o nome da instância de banco de dados para mostrar os detalhes.

  4. Na seção Resumo, copie o endpoint. Além disso, anote o número da porta. Você precisará do endpoint e do número da porta para conectar-se à instância de banco de dados.

Se você precisar encontrar as informações de nome de usuário e senha, escolha a guia Detalhes da configuração e escolha a influxAuthParametersSecretArn para acessar seu Secrets Manager.

Usando o CLI
  • Para encontrar as informações de conexão de uma instância de banco de dados InfluxDB usando o AWS CLI, chame o get-db-instance comando. Na chamada, consulte o ID, o endpoint, a porta e o influxAuthParameters segredo da instância de banco de dados.

    Para Linux, macOS ou Unix:

    aws timestream-influxdb get-db-instance --identifier id \ --query "[name,endpoint,influxAuthParametersSecretArn]"

    Para Windows:

    aws timestream-influxdb get-db-instance --identifier id \ --query "[name,endpoint,influxAuthParametersSecretArn]"

    Sua saída deve ser similar à seguinte. Para acessar as informações do nome de usuário, você precisará verificar InfluxAuthParameterSecret o.

    [ [ "mydb", "mydb-123456789012.us-east-1.timestream-influxdb.amazonaws.com", 8086, ] ]

Criação de tokens de acesso

Com essas informações, você poderá se conectar à sua instância para recuperar ou criar seus tokens de acesso. Existem várias maneiras de fazer isso:

Usando o CLI
  1. Se ainda não o fez, baixe, instale e configure o influx CLI.

  2. Ao configurar sua configuração do Influx, use --username-password para CLI autenticar.

    influx config create --config-name YOUR_CONFIG_NAME --host-url "https://yourinstance.timestream-influxdb.amazonaws.com:8086" --org yourorg --username-password admin --active
  3. Use o comando influx auth create para recriar seu token de operador. Leve em conta que esse processo invalidará o antigo token do operador.

    influx auth create --org kronos --operator
  4. Depois de ter o token do operador, você pode usar o comando influx auth list para visualizar todos os tokens de todos os seus tokens. Você pode usar o comando influx auth create para criar um token de acesso total.

Importante

Você precisará realizar esta etapa para obter primeiro seu token de operador e, em seguida, poder criar novos tokens usando o InfluxDB API ou. CLI

Usando a interface do usuário Influx
  1. Navegue até sua instância Timestream for InfluxDB usando o endpoint criado para fazer login e acessar a interface do usuário do InfluxDB. Você precisará usar o nome de usuário e a senha usados para criar sua instância de banco de dados InfluxDB. Você pode recuperar essas informações do influxAuthParametersSecretArn que foi especificado no objeto de resposta doCreateDbInstance.

    Como alternativa, você pode abrir o InfluxUI a partir do console de gerenciamento Timestream for InfluxDB:

    1. Faça login AWS Management Console e abra o console Amazon Timestream for InfluxDB em. https://console.aws.amazon.com/timestream/

    2. No canto superior direito do console Amazon Timestream for InfluxDB, escolha a região na qual você criou AWS a instância de banco de dados.

    3. Na lista Bancos de dados, escolha o nome da sua instância do InfluxDB para mostrar seus detalhes. No canto superior direito, escolha Open Influx UI.

  2. Depois de fazer login em seu InfluxUI, navegue até Carregar dados e depois APITokens usando a barra de navegação esquerda.

  3. Escolha + GENERATE API TOKEN e selecione All Access API Token.

  4. Insira uma descrição para o API token e escolha SAVE.

  5. Copie o token gerado e guarde-o para guardá-lo em segurança.

Importante

Ao criar tokens a partir do InfluxUI, os tokens recém-criados serão exibidos apenas uma vez. Certifique-se de copiá-los, caso contrário, você precisará recriá-los.

Usando o InfluxDB API
  • Envie uma solicitação para o API /api/v2/authorizations endpoint do InfluxDB usando o POST método de solicitação.

    Inclua o seguinte em sua solicitação:

    1. Cabeçalhos:

      1. Autorização: Token < INFLUX _ OPERATOR _ TOKEN >

      2. Tipo de conteúdo: application/json

    2. Corpo da solicitação: JSON corpo com as seguintes propriedades:

      1. status: “ativo”

      2. descrição: descrição do API token

      3. OrgID: ID da organização do InfluxDB

      4. permissões: matriz de objetos em que cada objeto representa permissões para um tipo de recurso do InfluxDB ou um recurso específico. Cada permissão contém as seguintes propriedades:

        1. ação: “ler” ou “escrever”

        2. recurso: JSON objeto que representa o recurso do InfluxDB para o qual conceder permissão. Cada recurso contém pelo menos a seguinte propriedade: OrgID: ID da organização do InfluxDB

        3. tipo: Tipo de recurso. Para obter informações sobre quais tipos de recursos do InfluxDB existem, use the /api/v2/resources endpoint.

O exemplo a seguir usa curl o InfluxDB API para gerar um token de acesso total:

export INFLUX_HOST=https://influxdb1-123456789.us-east-1.timestream-influxdb.amazonaws.com export INFLUX_ORG_ID=<YOUR_INFLUXDB_ORG_ID> export INFLUX_TOKEN=<YOUR_INFLUXDB_OPERATOR_TOKEN> curl --request POST \ "$INFLUX_HOST/api/v2/authorizations" \ --header "Authorization: Token $INFLUX_TOKEN" \ --header "Content-Type: text/plain; charset=utf-8" \ --data '{ "status": "active", "description": "All access token for get started tutorial", "orgID": "'"$INFLUX_ORG_ID"'", "permissions": [ {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "authorizations"}}, {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "authorizations"}}, {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "buckets"}}, {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "buckets"}}, {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "dashboards"}}, {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "dashboards"}}, {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "orgs"}}, {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "orgs"}}, {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "sources"}}, {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "sources"}}, {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "tasks"}}, {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "tasks"}}, {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "telegrafs"}}, {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "telegrafs"}}, {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "users"}}, {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "users"}}, {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "variables"}}, {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "variables"}}, {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "scrapers"}}, {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "scrapers"}}, {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "secrets"}}, {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "secrets"}}, {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "labels"}}, {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "labels"}}, {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "views"}}, {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "views"}}, {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "documents"}}, {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "documents"}}, {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notificationRules"}}, {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notificationRules"}}, {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notificationEndpoints"}}, {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notificationEndpoints"}}, {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "checks"}}, {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "checks"}}, {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "dbrp"}}, {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "dbrp"}}, {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notebooks"}}, {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notebooks"}}, {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "annotations"}}, {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "annotations"}}, {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "remotes"}}, {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "remotes"}}, {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "replications"}}, {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "replications"}} ] } '

Opções de autenticação do banco de dados

O Amazon Timestream para InfluxDB oferece suporte às seguintes formas de autenticar usuários do banco de dados:

  • Com a autenticação com senha, –sua instância de banco de dados executa toda a administração de contas do usuário. Você cria usuários, especifica senhas e administra tokens usando o InfluxUI, o Influx ou o CLI influx. API

  • Autenticação de token — Sua instância de banco de dados executa toda a administração das contas de usuário. Você pode criar usuários, especificar a senha e administrar tokens usando seu token de operador usando o Influx e o InfluxCLI. API

Conexões criptografadas

Você pode usar Secure Socket Layer (SSL) ou Transport Layer Security (TLS) do seu aplicativo para criptografar uma conexão com uma instância de banco de dados. Os certificados necessários para o TLS handshake entre o InfluxDB e os aplicativos criados e gerenciados pelo serviço Kronos. Quando o certificado é renovado, a instância é atualizada automaticamente com a versão mais recente sem exigir nenhuma intervenção do usuário.

Trabalhar com parameter groups

Database parameters (Parâmetros do banco de dados) especifica como o banco de dados é configurado. Por exemplo, os parâmetros do banco de dados podem especificar a quantidade de recursos, como memória, a serem alocados para um banco de dados.

Você gerencia a configuração do seu banco de dados associando suas instâncias de banco de dados a grupos de parâmetros. O Amazon Timestream para InfluxDB define grupos de parâmetros com configurações padrão. Você também pode definir seus próprios grupos de parâmetros com configurações personalizadas.

Visão geral dos grupos de parâmetros

Um grupo de parâmetros de banco de dados atua como um contêiner para valores de configuração de mecanismo que são aplicados a uma ou mais instâncias de bancos de dados.

Grupos de parâmetros padrão e personalizados

As instâncias de banco de dados usam grupos de parâmetros de banco de dados. As seções a seguir descrevem a configuração e o gerenciamento de grupos de parâmetros de instância de banco de dados.

Criar um grupo de parâmetros de banco de dados

Você pode criar um novo grupo de parâmetros de banco de dados usando o AWS Management Console AWS Command Line Interface, o ou o TimestreamAPI.

As seguintes limitações se aplicam ao nome do grupo de parâmetros de banco de dados:

  • O nome deve ter de 1 a 255 letras, números ou hifens.

  • Os nomes de grupos de parâmetros padrão podem incluir um ponto, como default.InfluxDB.2.7. No entanto, nomes de grupos de parâmetros personalizados não podem incluir um ponto.

  • O primeiro caractere deve ser uma letra.

  • O nome não pode começar com “dbpg-”

  • O nome não pode terminar com hífen nem conter dois hífens consecutivos.

  • Se você criar uma instância de banco de dados sem especificar um grupo de parâmetros de banco de dados, a instância de banco de dados usa os padrões do mecanismo InfluxDB.

Não é possível modificar as configurações de parâmetros de um grupo de parâmetros padrão. Em vez disso, você pode fazer o seguinte:

  1. Crie um novo grupo de parâmetros.

  2. Altere as configurações dos parâmetros desejados. Nem todos os parâmetros de mecanismo de banco de dados em um grupo de parâmetros podem ser modificados.

  3. Atualize sua instância de banco de dados para usar o grupo de parâmetros personalizado. Para obter informações sobre como atualizar uma instância de banco de dados, consulteAtualizar instâncias de banco de dados.

nota

Se você modificou sua instância de banco de dados para usar um grupo de parâmetros personalizado e iniciou a instância de banco de dados, o Amazon Timestream for InfluxDB reinicializa automaticamente a instância de banco de dados como parte do processo de inicialização.

Atualmente, você não poderá modificar grupos de parâmetros personalizados depois que eles forem criados. Se você precisar alterar um parâmetro, é necessário criar um novo grupo de parâmetros personalizado e atribuí-lo às instâncias que exigem essa alteração na configuração. Se você atualizar uma instância de banco de dados existente para atribuir um novo grupo de parâmetros, ela sempre será aplicada imediatamente e reinicializará sua instância.

Parâmetros estáticos e dinâmicos de instância de banco de dados

Os parâmetros da instância de banco de dados InfluxDB são sempre estáticos. Eles se comportam da seguinte maneira:

Quando você altera um parâmetro estático, salva o grupo de parâmetros do banco de dados e o atribui a uma instância, a alteração do parâmetro entra em vigor automaticamente após a reinicialização da instância.

Quando você associa um novo grupo de parâmetros de banco de dados a uma instância de banco de dados, o Timestream aplica os parâmetros estáticos modificados somente após a reinicialização da instância de banco de dados. Atualmente, a única opção é aplicar imediatamente.

Para obter mais informações sobre como alterar o grupo de parâmetros de banco de dados, consulte Atualizar instâncias de banco de dados.

Parâmetros e valores de parâmetros compatíveis

Para determinar os parâmetros compatíveis com sua instância de banco de dados, visualize os parâmetros no grupo de parâmetros de banco de dados usado pela instância de banco de dados. Para obter mais informações, consulte Visualização de valores de parâmetros para um grupo de parâmetros de banco de dados.

Para obter mais informações sobre todos os parâmetros suportados pela versão de código aberto do InfluxDB, consulte as opções de configuração do InfluxDB. Atualmente, você só poderá modificar os seguintes parâmetros do InfluxDB:

Parâmetro Descrição Valor padrão Valor Intervalo válido Observação
flux-log-enabled Inclui opção para mostrar registros detalhados para consultas do Flux FALSE true, false N/D
nível de registro Nível de saída do log. O InfluxDB gera entradas de log com níveis de severidade maiores ou iguais ao nível especificado. info depuração, informações, erro N/D
sem tarefas Número de consultas permitidas para execução simultânea. Definir como 0 permite um número ilimitado de consultas simultâneas. FALSE true, false N/D
simultaneidade de consultas Desative o agendador de tarefas. Se tarefas problemáticas impedirem o início do InfluxDB, use essa opção para iniciar o InfluxDB sem agendar ou executar tarefas. 1024 N/D
query-queue-size Número máximo de consultas permitidas na fila de execução. Quando o limite da fila é atingido, novas consultas são rejeitadas. Definir como 0 permite um número ilimitado de consultas na fila. 1024 N/D
tipo de rastreamento Ative o rastreamento no InfluxDB e especifique o tipo de rastreamento. O rastreamento está desativado por padrão. "" blog, jaeger N/D
métricas desativadas Desative o endpoint HTTP /metrics que expõe as métricas internas do InfluxDB. FALSE N/D
http-idle-timeout

Duração máxima em que o servidor deve manter as conexões estabelecidas ativas enquanto aguarda novas solicitações. Defina como 0 sem tempo limite.

30m0s Duração com unidadehours,minutes,seconds,milliseconds. Exemplo: durationType=minutes,value=10 Horas:

-Mínimo: 0

-Máximo: 256205

Minutos:

-Mínimo: 0

-Máximo: 15372286

Segundos:

-Mínimo: 0

-Máximo: 922337203

Milissegundos:

-Mínimo: 0

-Máximo: 922337203685

http-read-header-timeout

Duração máxima em que o servidor deve tentar ler HTTP os cabeçalhos de novas solicitações. Defina 0 para não perder tempo.

10s Duração com unidadehours,minutes,seconds,milliseconds. Exemplo: durationType=minutes,value=10 Horas:

-Mínimo: 0

-Máximo: 256205

Minutos:

-Mínimo: 0

-Máximo: 15372286

Segundos:

-Mínimo: 0

-Máximo: 922337203

Milissegundos:

-Mínimo: 0

-Máximo: 922337203685

http-read-timeout

Duração máxima em que o servidor deve tentar ler a totalidade das novas solicitações. Defina 0 para não perder tempo.

0 Duração com unidadehours,minutes,seconds,milliseconds. Exemplo: durationType=minutes,value=10 Horas:

-Mínimo: 0

-Máximo: 256205

Minutos:

-Mínimo: 0

-Máximo: 15372286

Segundos:

-Mínimo: 0

-Máximo: 922337203

Milissegundos:

-Mínimo: 0

-Máximo: 922337203685

http-write-timeout

Duração máxima que o servidor deve gastar processando e respondendo às solicitações de gravação. Defina 0 para não perder tempo.

0 Duração com unidadehours,minutes,seconds,milliseconds. Exemplo: durationType=minutes,value=10 Horas:

-Mínimo: 0

-Máximo: 256205

Minutos:

-Mínimo: 0

-Máximo: 15372286

Segundos:

-Mínimo: 0

-Máximo: 922337203

Milissegundos:

-Mínimo: 0

-Máximo: 922337203685

influxql-max-select-buckets

Número máximo de grupos por intervalos de tempo que uma SELECT declaração pode criar. 0permite um número ilimitado de baldes.

0 Longo

Mínimo: 0

Máximo: 9.223.372.036.854.775.807

influxql-max-select-point

Número máximo de pontos que uma SELECT declaração pode processar. 0permite um número ilimitado de pontos. O InfluxDB verifica a contagem de pontos a cada segundo (portanto, as consultas que excedem o máximo não são abortadas imediatamente).

0 Longo

Mínimo: 0

Máximo: 9.223.372.036.854.775.807

influxql-max-select-series

Número máximo de séries que uma SELECT declaração pode retornar. 0permite um número ilimitado de séries.

0 Longo

Mínimo: 0

Máximo: 9.223.372.036.854.775.807

pprof-desativado

Desative o /debug/pprof HTTP endpoint. Esse endpoint fornece dados de criação de perfil de tempo de execução e pode ser útil na depuração.

FALSE Booleano N/D
query-initial-memory-bytes

Bytes iniciais de memória alocados para uma consulta.

0 Longo

Mínimo: 0

Máximo: query-memory-bytes

query-max-memory-bytes

Total máximo de bytes de memória permitidos para consultas.

0 Longo

Mínimo: 0

Máximo: 9.223.372.036.854.775.807

query-memory-bytes

Especifica o tempo de vida (TTL) em minutos para sessões de usuário recém-criadas.

0 Longo

Mínimo: 0

Máximo: 2.147.483.647

Deve ser maior ou igual query-initial-memory-bytes a.
duração da sessão

Especifica o tempo de vida (TTL) em minutos para sessões de usuário recém-criadas.

60 Inteiro

Mínimo: 0

Máximo: 2880

session-renew-disabled

Desativa a extensão automática da sessão de um usuário TTL em cada solicitação. Por padrão, cada solicitação define o tempo de expiração da sessão para cinco minutos a partir de agora. Quando desativadas, as sessões expiram após a duração especificada da sessão e o usuário é redirecionado para a página de login, mesmo que esteja ativa recentemente.

FALSE Booleano N/D
storage-cache-max-memory-tamanho

Tamanho máximo (em bytes) que o cache do fragmento pode atingir antes de começar a rejeitar gravações.

1073741824 Longo

Mínimo: 0

Máximo: 549755813888

Deve ser menor que a capacidade total de memória da instância.

Recomendamos configurá-lo para menos de 15% da capacidade total de memória.

storage-cache-snapshot-memory-tamanho

Tamanho (em bytes) no qual o mecanismo de armazenamento capturará o cache e o gravará em um TSM arquivo para disponibilizar mais memória.

26214400 Longo

Mínimo: 0

Máximo: 549755813888

Deve ser menor que storage-cache-max-memory -size.

storage-cache-snapshot-write-duração do frio

Duração na qual o mecanismo de armazenamento fará uma captura instantânea do cache e o gravará em um novo TSM arquivo se o fragmento não tiver recebido gravações ou exclusões.

100m0s Duração com unidadehours,minutes,seconds,milliseconds. Exemplo: durationType=minutes,value=10 Horas:

-Mínimo: 0

-Máximo: 256205

Minutos:

-Mínimo: 0

-Máximo: 15372286

Segundos:

-Mínimo: 0

-Máximo: 922337203

Milissegundos:

-Mínimo: 0

-Máximo: 922337203685

storage-compact-full-write-duração do frio

Duração na qual o mecanismo de armazenamento compactará todos os TSM arquivos em um fragmento se não tiver recebido gravações ou exclusões.

40h00m Duração com unidadehours,minutes,seconds,milliseconds. Exemplo: durationType=minutes,value=10 Horas:

-Mínimo: 0

-Máximo: 256205

Minutos:

-Mínimo: 0

-Máximo: 15372286

Segundos:

-Mínimo: 0

-Máximo: 922337203

Milissegundos:

-Mínimo: 0

-Máximo: 922337203685

storage-compact-throughput-burst

Limite de taxa (em bytes por segundo) que TSM as compactações podem gravar no disco.

50331648 Longo

Mínimo: 0

Máximo: 9.223.372.036.854.775.807

storage-max-concurrent-compactions

Número máximo de compactações completas e niveladas que podem ser executadas simultaneamente. Um valor de 0 resulta em 50% do runtime.GOMAXPROCS(0) usado em tempo de execução. Qualquer número maior que zero limita as compactações a esse valor. Essa configuração não se aplica à captura instantânea de cache.

0 Inteiro

Mínimo: 0

Máximo: 64

storage-max-index-log-tamanho do arquivo

Tamanho (em bytes) no qual um arquivo log (WAL) de gravação antecipada de índice será compactado em um arquivo de índice. Tamanhos menores farão com que os arquivos de log sejam compactados mais rapidamente e resultarão em menor uso do heap em detrimento da taxa de transferência de gravação.

1048576 Longo

Mínimo: 0

Máximo: 9.223.372.036.854.775.807

storage-no-validate-field-tamanho

Ignore a validação do tamanho do campo nas solicitações de gravação recebidas.

FALSE Booleano N/D
storage-retention-check-interval

Intervalo de verificação da aplicação da política de retenção.

30m0s Duração com unidadehours,minutes,seconds,milliseconds. Exemplo: durationType=minutes,value=10 N/D Horas:

-Mínimo: 0

-Máximo: 256205

Minutos:

-Mínimo: 0

-Máximo: 15372286

Segundos:

-Mínimo: 0

-Máximo: 922337203

Milissegundos:

-Mínimo: 0

-Máximo: 922337203685

storage-series-file-max-concurrent-snapshot-compactions

Número máximo de compactações de instantâneos que podem ser executadas simultaneamente em todas as partições de série em um banco de dados.

0 Inteiro Mínimo: 0

Máximo: 64

storage-series-id-set-tamanho do cache

Tamanho do cache interno usado no TSI índice para armazenar resultados de séries calculados anteriormente. Os resultados em cache são retornados rapidamente, em vez de precisarem ser recalculados quando uma consulta subsequente com o mesmo predicado de chave/valor de tag é executada. Definir esse valor como 0 desativará o cache e poderá diminuir o desempenho da consulta.

100 Longo Mínimo: 0

Máximo: 9.223.372.036.854.775.807

storage-wal-max-concurrent-escreve

Número máximo de gravações no WAL diretório para tentar ao mesmo tempo.

0 Inteiro Mínimo: 0

Máximo: 256

storage-wal-max-write-atraso

O tempo máximo que uma solicitação de gravação no WAL diretório aguardará quando o número máximo de gravações ativas simultâneas no WAL diretório for atingido. Defina como 0 para desativar o tempo limite.

10 m Duração com unidadehours,minutes,seconds,milliseconds. Exemplo: durationType=minutes,value=10 Horas:

-Mínimo: 0

-Máximo: 256205

Minutos:

-Mínimo: 0

-Máximo: 15372286

Segundos:

-Mínimo: 0

-Máximo: 922337203

Milissegundos:

-Mínimo: 0

-Máximo: 922337203685

interface do usuário desativada

Desative a interface de usuário (UI) do InfluxDB. A interface do usuário está ativada por padrão.

FALSE Booleano N/D

Definir incorretamente os parâmetros em um grupo de parâmetros pode causar efeitos adversos não intencionais, inclusive diminuição da performance e instabilidade no sistema. Sempre tenha cuidado ao modificar os parâmetros do banco de dados. Experimente as alterações na configuração do grupo de parâmetros em uma instância de banco de dados de teste antes de aplicar essas alterações em uma instância de banco de dados de produção.

Trabalhar com grupos de parâmetros de banco de dados

As instâncias de banco de dados usam grupos de parâmetros de banco de dados. As seções a seguir descrevem a configuração e o gerenciamento de grupos de parâmetros de instância de banco de dados.

Criar um grupo de parâmetros de banco de dados

Usando o AWS Management Console
  1. Faça login AWS Management Console e abra o console Amazon Timestream for InfluxDB.

  2. No painel de navegação, escolha Parameter groups (Grupos de parâmetros).

  3. Escolha Create parameter group (Criar grupo de parâmetros).

  4. Insira o nome do novo grupo de parâmetros de banco de dados na caixa Group name (Nome do grupo).

  5. Insira uma descrição para o novo grupo de parâmetros de banco de dados na caixa Description (Descrição).

  6. Escolha os parâmetros para modificar e aplicar os valores desejados. Para obter mais informações sobre os parâmetros suportados, consulteParâmetros e valores de parâmetros compatíveis.

  7. Escolha Salvar.

Usando o AWS Command Line Interface
  • Para criar um grupo de parâmetros de banco de dados usando o AWS CLI, chame o create-db-parameter-group comando com os seguintes parâmetros:

    --db-parameter-group-name <value> --description <value> --endpoint_url <value> --region <value> --parameters (list) (string)
    exemplo Exemplo

    Para obter informações sobre cada configuração, consulte Configurações para instâncias de banco de dados. Este exemplo usa configurações de mecanismo padrão.

    aws timestream-influxdb create-db-parameter-group --db-parameter-group-name YOUR_PARAM_GROUP_NAME\ --endpoint-url YOUR_ENDPOINT --region YOUR_REGION \ --parameters "InfluxDBv2={logLevel=debug,queryConcurrency=10,metricsDisabled=true}" \" \ --debug

Associando um grupo de parâmetros de banco de dados a uma instância de banco de dados

Você pode criar seus próprios grupos de parâmetros de banco de dados com configurações personalizadas. Você pode associar um grupo de parâmetros de banco de dados a uma instância de banco de dados usando o AWS Management Console, o ou o AWS Command Line Interface API Timestream-InfluxDB. Você pode fazer isso ao criar ou modificar uma instância de banco de dados.

Para obter mais informações sobre como criar um parameter group de banco de dados, consulte Criar um grupo de parâmetros de banco de dados. Para obter informações sobre como criar uma instância de banco de dados, consulte Criar uma instância de banco de dados. Para obter informações sobre como modificar uma instância de banco de dados, consulte.. Atualizar instâncias de banco de dados

nota

Quando você associa um novo grupo de parâmetros de banco de dados a uma instância de banco de dados, os parâmetros estáticos modificados são aplicados somente após a reinicialização da instância de banco de dados. Atualmente, somente a inscrição imediata é suportada. O Timestream para InfluxDB suporta apenas parâmetros estáticos.

Usando o AWS Management Console
  1. Faça login AWS Management Console e abra o console Amazon Timestream for InfluxDB.

  2. No painel de navegação, escolha Bancos de dados InfluxDB e, em seguida, escolha a instância de banco de dados que você deseja modificar.

  3. Selecione Atualizar. A página Atualizar instância de banco de dados é exibida.

  4. Altere a configuração do grupo de parâmetros de banco de dados.

  5. Escolha Continue (Continuar) e verifique o resumo de modificações.

  6. Atualmente, somente a opção Aplicar imediatamente é suportada. Essa opção pode causar uma interrupção em alguns casos, pois reinicializará sua instância de banco de dados.

  7. Na página de confirmação, revise suas alterações. Se estiverem corretas, escolha Atualizar instância de banco de dados para salvar suas alterações e aplicá-las. Ou escolha Back (Voltar) para editar as alterações ou Cancel (Cancelar) para cancelar as alterações.

Usando o AWS Command Line Interface

Para Linux, macOS ou Unix:

aws timestream-influxdb update-db-instance --identifier YOUR_DB_INSTANCE_ID \ --region YOUR_REGION \ --db-parameter-group-identifier YOUR_PARAM_GROUP_ID \ --log-delivery-configuration "{\"s3Configuration\": {\"bucketName\": \"${LOGGING_BUCKET}\", \"enabled\": false }}"

Para Windows:

aws timestream-influxdb update-db-instance --identifier YOUR_DB_INSTANCE_ID ^ --region YOUR_REGION ^ --db-parameter-group-identifier YOUR_PARAM_GROUP_ID ^ --log-delivery-configuration "{\"s3Configuration\": {\"bucketName\": \"${LOGGING_BUCKET}\", \"enabled\": false }}"

Listar grupos de parâmetros de banco de dados

Você pode listar os grupos de parâmetros de banco de dados que você criou para sua AWS conta.

Usando o AWS Management Console
  1. Faça login AWS Management Console e abra o console Amazon Timestream for InfluxDB.

  2. No painel de navegação, selecione Parameter groups.

  3. Os grupos de parâmetros de banco de dados aparecem em uma lista.

Usando o AWS Command Line Interface

Para listar todos os grupos de parâmetros de banco de dados de uma AWS conta, use o AWS Command Line Interface list-db-parameter-groups comando.

aws timestream-influxdb list-db-parameter-groups --region region

Para retornar grupos de parâmetros de banco de dados específicos para uma AWS conta, use o AWS Command Line Interface get-db-parameter-group comando.

aws timestream-influxdb get-db-parameter-group --region region --identifier identifier

Visualizar valores de parâmetros para um grupo de parâmetros de banco de dados

Você pode obter uma lista de todos os parâmetros em um grupo de parâmetros de banco de dados e seus valores.

Usando o AWS Management Console
  1. Faça login AWS Management Console e abra o console Amazon Timestream for InfluxDB.

  2. No painel de navegação, selecione Parameter groups.

  3. Os grupos de parâmetros de banco de dados aparecem em uma lista.

  4. Escolha o nome do grupo de parâmetros para ver sua lista de parâmetros.

Usando o AWS Command Line Interface

Para visualizar os valores dos parâmetros de um grupo de parâmetros do banco de dados, use o AWS Command Line Interface get-db-parameters comando com o seguinte parâmetro obrigatório.

--db-parameter-group-name

Usando o API

Para visualizar os valores dos parâmetros de um grupo de parâmetros do banco de dados, use o API GetDBParameters comando Timestream com o seguinte parâmetro obrigatório.

DBParameterGroupName