Configurar conectores

avance

Todavía estamos trabajando en esta característica, ¡pero nos encantaría que la probaras!

Esta característica se proporciona actualmente como parte de un programa de vista previa de conformidad con nuestras políticas de prelanzamiento.

Antes de consultar datos con Lens, necesita configurar conexiones a sus fuentes de datos. Lens proporciona tanto system connectors para acceder a los datos de NRDB como data connectors para conectarse a bases de datos externas y otras fuentes de datos.

System connectors

Lens proporciona tres system connectors para acceder a los datos de NRDB. Estos connectors están disponibles automáticamente y no requieren configuración.

Connector	Descripción	Nivel de acceso
Telemetry	Acceda a datos de telemetría de NRDB, como transacciones, logs y métricas.	Nivel de cuenta. Solo puede acceder a los datos de las cuentas en las que tiene permisos.
Entity	Acceda a datos de entidades de NRDB, incluidos servicios, hosts y aplicaciones.	Nivel de cuenta. Solo puede acceder a los datos de las cuentas en las que tiene permisos.
Materialized views	Acceda a datos de materialized view almacenados en NRDB (resultados de consultas que unen múltiples bases de datos).	Nivel de organización. Todos los usuarios con acceso Lens pueden consultar materialized views .

Connector

Descripción

Nivel de acceso

Telemetry

Acceda a datos de telemetría de NRDB, como transacciones, logs y métricas.

Nivel de cuenta. Solo puede acceder a los datos de las cuentas en las que tiene permisos.

Entity

Acceda a datos de entidades de NRDB, incluidos servicios, hosts y aplicaciones.

Nivel de cuenta. Solo puede acceder a los datos de las cuentas en las que tiene permisos.

Materialized views

Acceda a datos de

materialized view

almacenados en NRDB (resultados de consultas que unen múltiples bases de datos).

Nivel de organización. Todos los usuarios con acceso

Lens

pueden consultar

materialized views

Data connectors

Data connectors conectar Lens a fuentes de datos externas como bases de datos, almacenes de datos y hojas de cálculo. Para crear, editar o eliminar connectors, necesita permisos RBAC específicos.

Control de acceso

Lens proporciona dos formas de controlar quién puede consultar connectors:

Permisos RBAC: Los usuarios con permisos RBAC Lens connectors pueden consultar todos los connectors de la organización.
Control de acceso detallado: Los usuarios sin permisos RBAC amplios aún pueden consultar connectors específicos si se les otorga acceso detallado a esos connectors.

Crear un connector

Para configurar un data connector:

Vaya a one.newrelic.com > Administration > Connectors.
Haga clic en Create a connector.
Seleccione su tipo de connector del menú desplegable.
Ingrese la información de conexión requerida para el tipo de connector seleccionado.
Para otorgar acceso a este conector a usuarios o grupos que no tienen permisos RBAC, configure el control de acceso detallado desde la sección Access control:
1. Seleccione el Auth domain que contiene los usuarios o grupos.
2. Seleccione el User or group.
3. Seleccione el rolLens Viewer.
4. Para agregar más usuarios o grupos, haga clic en Add y repita los pasos anteriores.
Haga clic en Create.

Después de crear un connector:

Para ver el esquema o eliminar el connector, seleccione el menú de la fila connector.
Para actualizar la configuración de control de acceso, seleccione el connector, agregue o elimine concesiones de acceso y guarde los cambios.
Para actualizar la configuración de connector, elimine y vuelva a crear el connector con los nuevos detalles.

Connector

Seleccione su tipo de connector para ver los campos requeridos.

Conéctese a Google Sheets para consultar datos de hojas de cálculo directamente desde Lens.

Parámetro	Descripción
Nombre	Un nombre único para identificar este connector al escribir consultas. Por ejemplo, `gsheets` o `employee_data` .
clave_de_credencial	La clave JSON codificada en base64 para su cuenta de servicio de Google Cloud. Esto autentica Lens con la API de Google Sheets. Consulte Generar la clave de credenciales de la cuenta de servicio para obtener instrucciones.
sheet_id	El ID de su hoja de cálculo de Google de metadatos que contiene información sobre todas las hojas a las que desea acceder a través de Lens . Consulte Configurar el acceso a Google Sheets para obtener instrucciones.

Parámetro

Descripción

Nombre

Un nombre único para identificar este

connector

al escribir consultas. Por ejemplo,

gsheets

employee_data

clave_de_credencial

La clave JSON codificada en base64 para su cuenta de servicio de Google Cloud. Esto autentica

Lens

con la API de Google Sheets. Consulte

Generar la clave de credenciales de la cuenta de servicio

para obtener instrucciones.

sheet_id

El ID de su hoja de cálculo de Google de metadatos que contiene información sobre todas las hojas a las que desea acceder a través de

Lens

. Consulte

Configurar el acceso a Google Sheets

para obtener instrucciones.

Generar la clave de credenciales de la cuenta de servicio

Para autenticar Lens con Google Sheets, debe crear una cuenta de servicio de Google Cloud y generar una clave JSON.

Crear una cuenta de servicio

Para crear una cuenta de servicio de Google Cloud, siga las instrucciones en Crear cuentas de servicio.

Configurar permisos para la creación de claves

Para crear claves para su cuenta de servicio, necesita los permisos adecuados. Para obtener información sobre los permisos necesarios, consulte Permisos necesarios.

Crear una clave JSON

Para generar una clave JSON para su cuenta de servicio, siga los pasos en Crear una clave de cuenta de servicio.

Convertir la clave JSON a base64

Para usar la clave JSON en Lens, convierta todo el contenido del archivo JSON a codificación base64 y guárdelo en un archivo de texto.

Configurar el acceso a Google Sheets

Después de generar la clave de credenciales, configure el acceso a sus Google Sheets.

Para permitir que Lens acceda a sus datos, otorgue permisos de lectura a la dirección de correo electrónico de la cuenta de servicio para cada hoja de cálculo de Google que desee conectar.

Crear una hoja de metadatos

Para administrar las hojas disponibles para Lens, cree una nueva hoja de cálculo de Google con las siguientes cuatro columnas:

Sheetname: El nombre de cada hoja a la que desea acceder con Lens. Todas las hojas listadas deben ser accesibles para la cuenta de servicio.
Sheetid: El identificador único de cada hoja. Puede encontrar esto en la URL de la hoja: https://docs.google.com/spreadsheets/d/SHEET_ID/edit.
Propietario: El propietario de la hoja. Usar Trino como valor predeterminado.
Notas: Cualquier nota o descripción adicional para la hoja.

Para permitir que Lens lea los metadatos, otorgue permiso de lectura a su cuenta de servicio para la hoja de metadatos.

Copiar el ID de la hoja de metadatos

Para configurar el connector, copie el ID de la hoja de la URL de la hoja de metadatos. El ID de la hoja aparece en la URL como: https://docs.google.com/spreadsheets/d/SHEET_ID/edit.

Conéctese a tablas Apache Iceberg almacenadas en AWS usando Glue Data Catalog para la gestión de metadatos.

Parámetro	Descripción	Valor de muestra
Nombre	Un nombre único para identificar este connector al escribir consultas.	`CostDB` , `Customermetadata`
aws_region	La región de AWS donde se almacenan sus tablas Iceberg. Obtenga esto de su equipo de infraestructura.	`us-east-2`
glue_catalog_id	Su ID de cuenta de AWS de 12 dígitos que identifica de forma única su Catálogo de datos de Glue dentro de la región. Encuentre esto en la Consola de AWS en Account Settings .	`123456789012`
aws_iam_role_arn	El Nombre de recurso de Amazon (ARN) de un rol de IAM que otorga a Lens acceso a su Catálogo de Glue y bucket de S3. Consulte Otorgar a Lens acceso a sus recursos de AWS para obtener instrucciones de configuración.	`arn:aws:iam::123456789012:role/ExampleRole`
aws_iam_external_id	El ID externo que configuró en la política de confianza de su rol de IAM. Consulte Otorgar a Lens acceso a sus recursos de AWS para obtener instrucciones de configuración.	`a1b2c3d4-e5f6-7890-1234-567890abcdef`

Conceder Lens

Para permitir que Lens consulte sus tablas Iceberg, cree una política y un rol de IAM en su cuenta de AWS que otorguen acceso de lectura a su Glue Data Catalog y a su bucket de S3.

Importante

El Glue Data Catalog y el bucket de S3 que contiene sus datos de Iceberg deben estar en la misma región de AWS.

Crear una política de IAM

Cree una política de IAM con los siguientes permisos para permitir que Lens lea los metadatos de Glue y los archivos de datos en S3. Reemplace {REGION}, {ACCOUNT_ID}, {DATABASE_NAME} y {S3_BUCKET_NAME} con sus valores. Tome nota del nombre de la política que ingrese, ya que lo necesitará para adjuntar esta política al rol de IAM.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Action": [
        "glue:GetDatabase",
        "glue:GetTable",
        "glue:GetTables",
        "glue:SearchTables",
        "glue:GetPartition",
        "glue:GetPartitions",
        "glue:BatchGetPartition"
      ],
      "Effect": "Allow",
      "Resource": [
        "arn:aws:glue:{REGION}:{ACCOUNT_ID}:catalog",
        "arn:aws:glue:{REGION}:{ACCOUNT_ID}:database/{DATABASE_NAME}",
        "arn:aws:glue:{REGION}:{ACCOUNT_ID}:table/*"
      ]
    },
    {
      "Action": ["s3:GetObject", "s3:ListBucket", "s3:GetBucketLocation"],
      "Effect": "Allow",
      "Resource": [
        "arn:aws:s3:::{S3_BUCKET_NAME}",
        "arn:aws:s3:::{S3_BUCKET_NAME}/*"
      ]
    }
  ]
}

Cree un rol de IAM con una relación de confianza

Cree un rol de IAM y configure la relación de confianza para permitir que la cuenta de servicio de Lens lo asuma mediante un ID externo único. Al configurar el rol, utilice estos valores:

Tipo de entidad de confianza: Cuenta de AWS
ID de cuenta: 017663287629 (cuenta de AWS de New Relic)
Requerir ID externo: Habilitado. Ingrese una cadena única de su elección y guárdela para la configuración de Lens connector.

Política de permisos: Busque el nombre de la política que creó en el paso anterior y selecciónelo.

La política de confianza debe coincidir con el siguiente formato. Reemplace <YOUR_EXTERNAL_ID> por el ID externo que ingresó.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::017663287629:user/service_fdp_customer_account_data_access"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "sts:ExternalId": "<YOUR_EXTERNAL_ID>"
        }
      }
    }
  ]
}

Después de crear el rol, abra la página de resumen del rol y copie el Role ARN. Necesitará este ARN y el ID externo al configurar Lens connector.

Conéctese a Snowflake almacenes de datos para consultar sus datos en la nube.

Parámetro	Descripción	Valor de muestra
Nombre	Un nombre único para identificar este connector al escribir consultas.	`Employeedata`
nombre de usuario	Su nombre de usuario de Snowflake para la autenticación.	`user123`
contraseña	La contraseña para su usuario de Snowflake.	`password@123`
URL de conexión	La URL JDBC para conectarse a Snowflake. Formato: `jdbc:snowflake://ACCOUNT.snowflakecomputing.com` .	`jdbc:snowflake://ACCOUNT.snowflakecomputing.com`
cuenta	Su identificador de cuenta de Snowflake. Encuentre esto en su URL de Snowflake o en la Consola de Snowflake en Admin > Accounts .	`ACCOUNT`
Base de datos	El nombre de la base de datos de Snowflake a la que desea conectarse.	`DATABASE`
role	El rol de Snowflake asignado a su usuario. Esto determina sus permisos de acceso.	`ROLE`
almacén	El nombre del almacén de Snowflake que se utilizará para los recursos de cómputo.	`WAREHOUSE`

Conéctese a bases de datos PostgreSQL para consultar sus datos relacionales.

Parámetro	Descripción	Valor de muestra
Nombre	Un nombre único para identificar este connector al escribir consultas.	`salesdata`
URL de conexión	La URL de JDBC para conectarse a PostgreSQL. Formato: `jdbc:postgresql://[host]:[port]/[database]` .	`jdbc:postgresql://cluster.amazonaws.com:5432/test_db`
nombre de usuario	Su nombre de usuario de la base de datos PostgreSQL.	`username`
contraseña	La contraseña de su usuario de PostgreSQL.	`password`

Conéctese a bases de datos MySQL para consultar sus datos relacionales.

Parámetro	Descripción	Valor de muestra
Nombre	Un nombre único para identificar este connector al escribir consultas.	`CRMdata`
URL de conexión	La URL de JDBC para conectarse a MySQL. Formato: `jdbc:mysql://[host]:[port]/[database]` .	`jdbc:mysql://test-db-mysql.cluster-cl3aokvievxs.us-east-2.rds.amazonaws.com:3306/test_db`
nombre de usuario	Su nombre de usuario de la base de datos MySQL.	`username`
contraseña	La contraseña para su usuario de MySQL.	`password`

Conéctese a los almacenes de datos de Amazon Redshift para consultar sus datos de análisis.

Parámetro	Descripción	Valor de muestra
Nombre	Un nombre único para identificar este connector al escribir consultas.	`AppDB`
URL de conexión	La URL de JDBC para conectarse a Redshift. Formato: `jdbc:redshift://[host]:[port]/[database]` .	`jdbc:redshift://example.net:5439/database`
nombre de usuario	Su nombre de usuario de la base de datos Redshift.	`root`
contraseña	La contraseña para su usuario de Redshift.	`password`

Conéctese a Prometheus para consultar sus datos de métricas.

Parámetro	Descripción	Valor de muestra
Nombre	Un nombre único para identificar este connector al escribir consultas.	`MetricsDB`
URI	La URL de su servidor Prometheus.	`http://localhost:9090`
nombre de usuario (opcional)	Nombre de usuario para la autenticación básica si su servidor Prometheus lo requiere.	`username`
contraseña (opcional)	Contraseña para la autenticación básica.	`password`
query_chunk_duration (opcional)	La duración de cada fragmento de consulta enviado a Prometheus. Los fragmentos más pequeños reducen el uso de memoria, pero aumentan el número de solicitudes.	`1d`
max_query_range (opcional)	El rango de tiempo máximo para las consultas. Lens divide este rango en fragmentos según `query_chunk_duration` .	`21d`
cache_ttl (opcional)	Cuánto tiempo almacenar en caché los valores de esta fuente de datos antes de actualizar.	`30s`

Conéctese a bases de datos MongoDB para consultar sus datos de documentos.

Importante

No puede leer su URL de conexión después de configurarla porque contiene información confidencial, como su contraseña.

Parámetro	Descripción	Valor de muestra
Nombre	Un nombre único para identificar este connector al escribir consultas.	`CustomerDB`
URL de conexión	La cadena de conexión de MongoDB. Formato: `mongodb://<user>:<pass>@<host>:<port>/` . Tanto el nombre de usuario como la contraseña deben estar codificados en URL.	`mongodb://user:pass@cluster.mongodb.net:27017/`

Parámetro

Descripción

Valor de muestra

Nombre

Un nombre único para identificar este

connector

al escribir consultas.

CustomerDB

URL de conexión

La cadena de conexión de MongoDB. Formato:

mongodb://<user>:<pass>@<host>:<port>/

. Tanto el nombre de usuario como la contraseña deben estar codificados en URL.

mongodb://user:pass@cluster.mongodb.net:27017/

Para los usuarios de MongoDB Atlas : El nombre de usuario y la contraseña que ingresa en Lens son sus credenciales de usuario de base de datos, no las credenciales que usa para iniciar sesión en la interfaz web de Atlas.

Codificación URL: Su nombre de usuario y contraseña deben estar codificados en URL.

Conéctese a Elasticsearch para consultar sus datos de búsqueda y análisis.

Parámetro	Descripción	Valor de muestra
Nombre	Un nombre único para identificar este connector al escribir consultas.
anfitrión	El nombre de host o la dirección IP de su servidor Elasticsearch.
port	El número de puerto para su servidor Elasticsearch.
seguridad	El método de seguridad para la autenticación.
nombre de usuario	Su nombre de usuario de Elasticsearch para autenticación.
contraseña	La contraseña para su usuario de Elasticsearch.
tls_enabled (opcional)	Habilite TLS para conexiones seguras a su servidor Elasticsearch.

Conéctese a AWS CloudWatch para consultar sus datos de monitoreo en la nube.

Importante

El connector de CloudWatch es específico de la región. Cree connectors independientes para cada región de AWS que desee consultar.

Parámetro	Descripción	Valor de muestra
Nombre	Un nombre único para identificar este connector al escribir consultas.	`cloudwatch-metrics`
aws_region	La región de AWS donde se almacenan sus datos de CloudWatch.	`us-east-2`
aws_iam_role_arn	El Nombre de recurso de Amazon (ARN) de un rol de IAM que otorga acceso a Lens a sus datos de CloudWatch. Consulte Otorgar a Lens acceso a CloudWatch para obtener instrucciones de configuración.	`arn:aws:iam::123456789012:role/LensCloudwatchAccessRole`
aws_iam_external_id	El ID externo que configuró en la política de confianza de su rol de IAM. Consulte Otorgar a Lens acceso a CloudWatch para obtener instrucciones de configuración.	`newreliclensusercloudwatchaccess`

Conceder Lens

Para permitir que Lens consulte sus métricas de CloudWatch, cree una política y un rol de IAM en su cuenta de AWS que otorguen acceso de lectura a CloudWatch.

Crear una política de IAM

Cree una política de IAM con los siguientes permisos para permitir que Lens lea las métricas de CloudWatch de su cuenta de AWS. Anote el nombre de la política que ingrese, ya que lo necesitará para adjuntar esta política al rol de IAM.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "cloudwatch:ListMetrics",
        "cloudwatch:GetMetricData",
        "cloudwatch:GetMetricStatistics",
        "tag:GetResources"
      ],
      "Resource": "*"
    }
  ]
}

Cree un rol de IAM con una relación de confianza

Cree un rol de IAM y configure la relación de confianza para permitir que la cuenta de servicio de Lens lo asuma mediante un ID externo único. Al configurar el rol, utilice estos valores:

Tipo de entidad de confianza: Cuenta de AWS
ID de cuenta: 017663287629 (cuenta de AWS de New Relic)
Requerir ID externo: Habilitado. Ingrese una cadena única de su elección y guárdela para la configuración de Lens connector.

Política de permisos: Busque el nombre de la política que creó en el paso anterior y selecciónelo.

La política de confianza debe coincidir con el siguiente formato. Reemplace <YOUR_EXTERNAL_ID> por el ID externo que ingresó.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::017663287629:user/service_fdp_customer_account_data_access"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "sts:ExternalId": "<YOUR_EXTERNAL_ID>"
        }
      }
    }
  ]
}

Después de crear el rol, abra la página de resumen del rol y copie el Role ARN. Necesitará este ARN y el ID externo al configurar Lens connector.

Conéctese a ClickHouse para consultar sus datos de análisis.

Parámetro	Descripción	Valor de muestra
Nombre	Un nombre único para identificar este connector al escribir consultas.	`AnalyticsDB`
nombre de usuario	Su nombre de usuario de la base de datos ClickHouse.	`admin`
contraseña	La contraseña para su usuario de ClickHouse.	`password`
URL de conexión	La URL de JDBC para conectarse a ClickHouse. Formato: `jdbc:clickhouse://<host>:8123/<database>?ssl=true` .	`jdbc:clickhouse://clickhouse.example.com:8123/analytics_db?ssl=true`

Conéctese a Microsoft SQL Server para consultar sus datos relacionales.

Parámetro	Descripción	Valor de muestra
Nombre	Un nombre único para identificar este connector al escribir consultas.	`SalesDB`
URL de conexión	La URL de JDBC para conectarse a SQL Server. Formato: `jdbc:sqlserver://<host>:<port>;databaseName=<database>;encrypt=false` .	`jdbc:sqlserver://sqlserver.example.com:1433;databaseName=sales_db;encrypt=false`
nombre de usuario	Su nombre de usuario de la base de datos SQL Server.	`sa`
contraseña	La contraseña para su usuario de SQL Server.	`password`

Descripción general de Lens

Aprenda sobre las características, los casos de uso y los permisos de Lens.

Consultar datos con Lens

Consulta datos en Query Builder, Notebooks y dashboards.

Te ofrecemos esta traducción automática para facilitar la lectura.

avance

System connectors

Data connectors

Control de acceso

Crear un connector

Connector

Conector de Google Sheets

Generar la clave de credenciales de la cuenta de servicio

Crear una cuenta de servicio

Configurar permisos para la creación de claves

Crear una clave JSON

Convertir la clave JSON a base64

Configurar el acceso a Google Sheets

Crear una hoja de metadatos

Copiar el ID de la hoja de metadatos

Conector de Iceberg

Conceder Lens

Importante

Crear una política de IAM

Cree un rol de IAM con una relación de confianza

Conector de Snowflake

Conector de PostgreSQL

Conector de MySQL

Conector de Redshift

Conector de Prometheus

Conector de MongoDB

Importante

Conector de Elasticsearch

Conector de AWS CloudWatch

Importante

Conceder Lens

Crear una política de IAM

Cree un rol de IAM con una relación de confianza

Conector de ClickHouse

Conector de SQL Server

Descripción general de Lens

Consultar datos con Lens

Te ofrecemos esta traducción automática para facilitar la lectura.

Configurar conectores

avance

System connectors .css-21sua1{background:none;border:none;width:0;padding:0;}

Data connectors

Control de acceso

Crear un connector

Connector

Conector de Iceberg

Conector de Snowflake

Conector de PostgreSQL

Conector de MySQL

Conector de Redshift

Conector de Prometheus

Conector de MongoDB

Conector de Elasticsearch

Conector de AWS CloudWatch

Conector de ClickHouse

Conector de SQL Server

Temas relacionados

Descripción general de Lens

Consultar datos con Lens

System connectors