Configura métricas del cliente
En esta página, se describe cómo instalar, configurar y usar Bigtable del cliente métricas.
Las métricas del cliente están disponibles para los usuarios de las siguientes bibliotecas cliente:
- Biblioteca cliente de Bigtable para Java
- Cliente de HBase de Bigtable para Java
- Biblioteca cliente de Bigtable para Go
Para obtener una descripción general, consulta Descripción general de las métricas del cliente. Para obtener una lista detallada de las métricas, consulta Descripciones de las métricas del cliente.
Agrega o confirma los permisos de la cuenta de servicio
Para agregar permisos de IAM a la cuenta de servicio, completa lo siguiente:
En la consola de Google Cloud, ve a la página IAM.
Selecciona el proyecto en el que creaste el clúster de Bigtable.
Busca la cuenta de servicio a la que quieres agregar el permiso.
Haz clic en Editar principal.
Haz clic en Agregar otro rol.
Busca "escritor de métricas de supervisión" y selecciona el resultado.
Haz clic en Guardar.
Habilita la API de Cloud Monitoring
En la consola de Google Cloud, ve a la página API y servicios.
Selecciona el proyecto en el que creaste el clúster de Bigtable.
Haz clic en Habilitar APIs y servicios.
Busca “Monitoring”.
En los resultados de la búsqueda, haz clic en "API de Monitoring" de Stackdriver.
Si se muestra "API habilitada", significa que la API ya está habilitada. De lo contrario, haz clic en Habilitar.
Configura tu biblioteca cliente de Bigtable
Después de habilitar la API de Cloud Monitoring, configura tu Bigtable biblioteca cliente.
Go
Sigue estos pasos si usas Bigtable para Go, que llama a las APIs de Bigtable.
Instala y configura la biblioteca cliente para Go
Actualiza la biblioteca cliente de Bigtable para Go a la versión 1.27.0.
más adelante. Tu go.mod
debería ser similar al siguiente:
require (
cloud.google.com/go/bigtable v1.27.2-0.20240725222120-ce31365acc54
Opcional: Inhabilita las métricas del cliente
Las métricas del cliente están habilitadas de forma predeterminada en la biblioteca cliente de Go. Para inhabilitar esta opción, pasa NoopMetricsProvider
en ClientConfig
:
client, err := bigtable.NewClientWithConfig(ctx, project, instance,
bigtable.ClientConfig{MetricsProvider: bigtable.NoopMetricsProvider{},
})
HBase
Sigue estos pasos si usas el cliente de Bigtable HBase para Java, que llama a la API de HBase, para conectar tu aplicación a Bigtable.
Instala y configura la biblioteca cliente de HBase para Java
Descarga e instala el cliente de HBase de Bigtable para Java más reciente. Para habilitar las métricas del cliente, debes usar la versión 2.6.4 o posterior.
Crea un proyecto de Maven vacío.
Determina la dependencia de artefacto adecuada para tu caso de uso. El
2.x
incluyen un cliente asíncrono de HBase que las versiones de1.x
no tienen.bigtable-hbase-1.x
obigtable-hbase-2.x
: Úsalo para aplicaciones independientes en las que tienes el control de tus dependencias.bigtable-hbase-1.x-hadoop
obigtable-hbase-2.x-hadoop
: Se usa en Hadoop. entornos de prueba.bigtable-hbase-1.x-shaded
obigtable-hbase-2.x-shaded
: Se usan en entornos. además de Hadoop, que requieren versiones anteriores de componentes, como protobufs o Guava.
Actualiza el archivo pom.xml:
<dependencyManagement> <dependencies> <dependency> <groupId>com.google.cloud.bigtable</groupId> <artifactId>BIGTABLE_HBASE_ARTIFACT</artifactId> <version>VERSION_NUMBER</version> </dependency> </dependencies> </dependencyManagement>
Proporcione lo siguiente:
BIGTABLE_HBASE_ARTIFACT
: Es la dependencia del artefacto para tu proyecto, con el formatobigtable-hbase-1.x
obigtable-hbase-2.x-hadoop
.VERSION_NUMBER
: Es la versión de la biblioteca cliente que usas, con el formato2.6.4
.
Habilita las métricas del cliente en tu aplicación
Usa bigtable-hbase-1.x
o bigtable-hbase-2.x
Cuando creas una conexión con la biblioteca cliente de HBase y los artefactos bigtable-hbase-1.x
o bigtable-hbase-2.x
, el código para habilitar las métricas integradas del cliente se ve de la siguiente manera:
import com.google.cloud.bigtable.data.v2.BigtableDataSettings;
Configuration configuration = BigtableConfiguration.configure("my-project-id", "my-instance-id");
Connection connection = new BigtableConnection(configuration);
BigtableDataSettings.enableBuiltinMetrics();
Usa artefactos -hadoop
o -shaded
Cuando creas una conexión con la biblioteca cliente de HBase y uno de los artefactos -hadoop
o -shaded
, el código para habilitar las métricas integradas del cliente se ve de la siguiente manera:
import com.google.bigtable.repackaged.com.google.cloud.bigtable.data.v2.BigtableDataSettings;
Configuration configuration = BigtableConfiguration.configure("my-project-id", "my-instance-id");
Connection connection = new BigtableConnection(configuration);
BigtableDataSettings.enableBuiltinMetrics();
Opcional: Inhabilita las métricas del cliente
Si usas la versión 2.14.1 o una posterior, las métricas del cliente estarán habilitadas de forma predeterminada. Puedes inhabilitar esta opción.
Configuration configuration = BigtableConfiguration.configure("my-project-id", "my-instance-id");
configuration.setBoolean(BigtableOptionsFactory.BIGTABLE_ENABLE_CLIENT_SIDE_METRICS, false);
Connection connection = new BigtableConnection(configuration);
Java
Sigue estos pasos si usas Bigtable para Java, que llama a las APIs de Bigtable.
Antes de comenzar
Opcional: Si usas OpenCensus
Estadísticas
para obtener métricas de Bigtable, revertir la dependencia y
StackdriverStatsExporter
cambios en tu aplicación. Para entender por qué, consulta
Cuándo hacer la actualización.
Instala y configura la biblioteca cliente para Java
- Descarga e instala la biblioteca cliente de Bigtable más reciente para Java Debes tener la versión 2.16.0 o una posterior para usar las métricas del cliente.
Actualiza el archivo pom.xml de la biblioteca cliente de Java para usar la versión más reciente. Tu pom debería verse similar al siguiente:
<dependencyManagement> <dependencies> <dependency> <groupId>com.google.cloud</groupId> <artifactId>google-cloud-bigtable-bom</artifactId> <version>2.38.0</version> <scope>import</scope> <type>pom</type> </dependency> </dependencies> </dependencyManagement> <dependencies> <dependency> <groupId>com.google.cloud</groupId> <artifactId>google-cloud-bigtable</artifactId> </dependency> </dependencies>
Habilita las métricas del cliente en tu aplicación
Cuando crees un cliente usando la biblioteca cliente, habilita el módulo métricas. El código debería ser similar al siguiente:
BigtableDataSettings settings = BigtableDataSettings.newBuilder()
.setProjectId("our-project-2-12")
.setInstanceId("our-instance-85")
.setAppProfileId("our-appProfile-06")
.build();
BigtableDataSettings.enableBuiltinMetrics();
try (BigtableDataClient client = BigtableDataClient.create(settings)) {
// Application logic
}
Configura una instancia personalizada de OpenTelemetry
Si usas la versión 2.38.0 o una posterior y deseas publicar métricas del cliente en Cloud Monitoring y en sinks personalizados, puedes configurar una instancia personalizada de OpenTelemetry.
SdkMeterProviderBuilder meterProviderBuilder = SdkMeterProvider.builder();
// register client side metrics on your meter provider
BuiltinMetricsView.registerBuiltinMetrics("my-project-id", meterProviderBuilder);
// register other metric reader and views
meterProviderBuilder.registerMetricReader().registerView();
// create the OTEL instance
OpenTelemetry openTelemetry = OpenTelemetrySdk.builder()
.setMeterProvider(meterProviderBuilder.build())
.build();
// Override MetricsProvider in BigtableDataSettings
BigtableDataSettings settings = BigtableDataSettings.newBuilder()
.setProjectId("my-project-id")
.setInstanceId("my-instance-id")
.setMetricsProvider(CustomOpenTelemetryMetricsProvider.create(openTelemetry))
.build();
try (BigtableDataClient client = BigtableDataClient.create(settings)) {
// Application logic
}
Opcional: Inhabilita las métricas del cliente
Si usas la versión 2.38.0 o una posterior, puedes inhabilitar la métricas del cliente.
BigtableDataSettings settings = BigtableDataSettings.newBuilder()
.setProjectId("my-project")
.setInstanceId("my-instance")
.setMetricsProvider(NoopMetricsProvider.INSTANCE)
.build();
Visualiza métricas en el Explorador de métricas
En la consola de Google Cloud, ve a la página Explorador de métricas.
Selecciona el proyecto.
Haz clic en Elige una métrica.
Busca
bigtable.googleapis.com/client
.Selecciona una métrica, un método
group by
y un estado, y elige un Agregador. Para explorar más opciones, consulta Selecciona métricas cuando uses el Explorador de métricas.
Luego de habilitar las métricas del cliente, permite que tu aplicación se ejecute durante al menos un minuto antes de comprobar si hay métricas publicadas.
¿Qué sigue?
- Lee una descripción general de las métricas del cliente.
- Consulta las descripciones completas de las métricas del cliente.
- Obtén más información sobre Bigtable Monitoring.