Para obtener capacidades similares a las de Amazon Timestream, considere Amazon Timestream LiveAnalytics para InfluxDB. Ofrece una ingesta de datos simplificada y tiempos de respuesta a las consultas en milisegundos de un solo dígito para realizar análisis en tiempo real. Obtenga más información aquí.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Conexión a una instancia de base de datos de Amazon Timestream para InfluxDB

Antes de conectarse a una instancia de base de datos, debe crear la instancia de base de datos. Para obtener información, consulte Creación de una instancia de base de datos. Después de que Amazon Timestream aprovisione su instancia de base de datos, use la API de InfluxDB, la CLI de Influx o cualquier utilidad o cliente compatible con InfluxDB para conectarse a la instancia de base de datos.

Búsqueda de la información de conexión para una instancia de base de datos de Amazon Timestream para InfluxDB

La información de conexión de una instancia de base de datos incluye su punto de conexión, puerto, nombre de usuario, contraseña y un token de acceso válido, como el token de operador o de acceso completo. Por ejemplo, para una instancia de base de datos de Timestream para InfluxDB, supongamos que el valor del punto de conexión es c5vasdqn0b-3ksj4dla5nfjhi.timestream-influxdb.us-east-1.on.aws. En este caso, el valor del puerto es 8086 y el usuario de la base de datos es admin. Con esta información, para acceder a la instancia utilizará lo siguiente:

Las instancias creadas antes del 9 de diciembre de 2024 tendrán un punto de conexión que incluirá el nombre de la instancia en lugar del ID. Por ejemplo: influxdb1-123456789.us-east-1.timestream-influxdb.amazonaws.com.

El punto de enlace es único para cada instancia de base de datos y los valores del puerto y del usuario pueden variar. Para conectarse a una instancia de base de datos, puede utilizar la CLI de Influx, la API de InfluxDB o cualquier cliente compatible con InfluxDB.

Para encontrar la información de conexión de una instancia de base de datos, utilice la consola de AWS administración. También puede utilizar el AWS comando de la interfaz de línea de describe-db-instances comandos (AWS CLI) o la operación Timestream for InfluxDB API. GetDBInstance

Si necesita encontrar la información de nombre de usuario y contraseña, seleccione la pestaña Detalles de configuración y elija el influxAuthParametersSecretArn para acceder a Secrets Manager.

Creación de tokens de acceso

Con esta información, podrá conectarse a su instancia para recuperar o crear sus tokens de acceso. Hay varias formas para realizar esto:

En el siguiente ejemplo, se utiliza curl y la API de InfluxDB para generar un token de acceso total:

export INFLUX_HOST=https://instanceid-123456789.timestream-influxdb.us-east-1.on.aws
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"}}
    ]
  }
'

Opciones de autenticación de bases de datos

Amazon Timestream para InfluxDB admite las siguientes formas de autenticar usuarios de bases de datos:

Conexiones cifradas

Puede utilizar SSL (Capa de conexión segura) o TLS (Transport Layer Security) desde una aplicación para cifrar una conexión a una instancia de base de datos. Los certificados necesarios para el establecimiento de comunicación TLS entre InfluxDB y las aplicaciones creadas y administradas por el servicio Kronos. Cuando se renueva el certificado, la instancia se actualiza automáticamente con la última versión sin que sea necesaria la intervención del usuario.

Working with parameter groups (Trabajar con grupos de parámetros)

Parámetros de la base de datos especificar cómo está configurada la base de datos. Por ejemplo, los parámetros de la base de datos pueden especificar la cantidad de recursos, como la memoria, que se asignarán a una base de datos.

Usted administra la configuración de la base de datos asociando las instancias de base de datos con grupos de parámetros. Amazon Timestream para InfluxDB define grupos de parámetros con la configuración predeterminada. También puede definir sus propios grupos de parámetros con una configuración personalizada.

Descripción general de los grupos de parámetros

Un grupo de parámetros de base de datos sirve de contenedor para los valores de configuración del motor que se aplican a una o varias instancias de bases de datos.

Grupos de parámetros predeterminados y personalizados

Las instancias de base de datos utilizan grupos de parámetros de base de datos. En las secciones siguientes se describe cómo configurar y administrar los grupos de parámetros de instancia de base de datos.

Creación de un grupo de parámetros de base de datos

Puede crear un nuevo grupo de parámetros de base de datos mediante la Consola de administración de AWS, la o la AWS Command Line Interface API Timestream.

Se aplican las siguientes limitaciones al nombre del grupo de parámetros de base de datos:

La configuración de los parámetros de un grupo de parámetros predeterminado no se puede modificar. En su lugar, puede hacer lo siguiente:

Parámetros de instancias de base de datos estáticos y dinámicos

Los parámetros de las instancias de base de datos de InfluxDB son siempre estáticos. Se comportan de la siguiente manera:

Cuando se cambia un parámetro estático, se guarda el grupo de parámetros de base de datos y se lo asigna a una instancia, el cambio de parámetros tendrá efecto automáticamente después de reiniciar la instancia.

Al asociar un nuevo grupo de parámetros de base de datos con una instancia de base de datos, Timestream aplica los parámetros estáticos modificados solo después de reiniciar la instancia de base de datos. Actualmente, la única opción es aplicarlos de forma inmediata.

Para obtener información sobre el cambio del grupo de parámetros de base de datos, consulte Actualización de instancias de base de datos.

Parámetros y valores de parámetros admitidos

Para determinar los parámetros compatibles con la instancia de base de datos, consulte los parámetros en el grupo de parámetros de base de datos utilizado por la instancia de base de datos. Para obtener más información, consulte Visualización de los valores de los parámetros de un grupo de parámetros de base de datos.

Para obtener más información sobre todos los parámetros compatibles con la versión de código abierto de InfluxDB, consulte Opciones de configuración de InfluxDB. Actualmente solo podrá modificar los siguientes parámetros de InfluxDB:

Si los parámetros de un grupo de parámetros se configuran de forma incorrecta, pueden producirse efectos adversos no deseados, como la degradación del rendimiento y la inestabilidad del sistema. Tenga siempre cuidado al modificar los parámetros de la base de datos. Pruebe los cambios de configuración de los grupos de parámetros en una instancia de base de datos de prueba antes de aplicar dichos cambios a una instancia de base de datos de producción.

Trabajo con los grupos de parámetros de base de datos

Las instancias de base de datos utilizan grupos de parámetros de base de datos. En las secciones siguientes se describe cómo configurar y administrar los grupos de parámetros de instancia de base de datos.

Creación de un grupo de parámetros de base de datos

Asociación de un grupo de parámetros de base de datos con una instancia de base de datos

Puede crear sus propios grupos de parámetros de base de datos con configuraciones personalizadas. Puede asociar un grupo de parámetros de base de datos a una instancia de base de datos mediante la Consola de administración de AWS AWS Command Line Interface API Timestream for InfluxDB. Puede hacerlo al crear o modificar una instancia de base de datos.

Para obtener información sobre la creación de un grupo de parámetros de base de datos, consulte Creación de un grupo de parámetros de base de datos. Para obtener información acerca de la creación de una instancia de base de datos, consulte Creación de una instancia de base de datos. Para obtener más información acerca de la modificación de una instancia de base de datos , consulte Actualización de instancias de base de datos.

Usando la AWS Command Line Interface

Para Linux, macOS o 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 }}"
                        
 

Descripción de grupos de parámetros de base de datos

Puede enumerar los grupos de parámetros de base de datos que ha creado para su AWS cuenta.

Usando la AWS Command Line Interface

Para enumerar todos los grupos de parámetros de base de datos de una AWS cuenta, utilice el AWS Command Line Interface list-db-parameter-groups comando.

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

Para devolver un grupo de parámetros de base de datos específico para una AWS cuenta, utilice el AWS Command Line Interface get-db-parameter-group comando.

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

Visualización de los valores de los parámetros de un grupo de parámetros de base de datos

Es posible obtener una lista de todos los parámetros de un grupo de parámetros de base de datos y sus valores.

Usando la AWS Command Line Interface

Para ver los valores de los parámetros de un grupo de parámetros de base de datos, utilice el AWS Command Line Interface get-db-parameter-group comando. parameter-group-identifierSustitúyalos por su propia información.

get-db-parameter-group --identifier parameter-group-identifier

Uso del API

Para ver los valores de los parámetros de un grupo de parámetros de base de datos, utilice el comando GetDbParameterGroup de la API de Timestream. parameter-group-identifierSustitúyala por tu propia información.

GetDbParameterGroup parameter-group-identifier