Configura métricas del cliente

Go

Sigue estos pasos si usas la biblioteca cliente de 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 o una posterior. 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

1. Descarga e instala la versión más reciente del cliente de HBase de Bigtable para Java. Para habilitar las métricas del cliente, debes usar la versión 2.6.4 o una posterior.

2. Crea un proyecto de Maven vacío.

3. Determina la dependencia de artefacto adecuada para tu caso de uso. Las versiones 2.x incluyen un cliente asíncrono de HBase que no tienen las versiones 1.x.

   • bigtable-hbase-1.x o bigtable-hbase-2.x: Úsalo para aplicaciones independientes en las que tienes el control de tus dependencias.
   • bigtable-hbase-1.x-hadoop o bigtable-hbase-2.x-hadoop: Se usa en entornos de Hadoop.
   • bigtable-hbase-1.x-shaded o bigtable-hbase-2.x-shaded: Úsalo en entornos que no sean de Hadoop y que requieran versiones anteriores de componentes, como protobufs o Guava.

4. 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: La dependencia del artefacto para tu proyecto, con el formato bigtable-hbase-1.x o bigtable-hbase-2.x-hadoop.
   • VERSION_NUMBER: Es la versión de la biblioteca cliente que usas, con el formato 2.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 se habilitan 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 la biblioteca cliente de Bigtable para Java, que llama a las APIs de Bigtable.

Antes de comenzar

Opcional: Si usas una integración de OpenCensus Stats para obtener métricas de Bigtable, revierte la dependencia y los cambios de StackdriverStatsExporter en tu aplicación. Para comprender por qué, consulta Cuándo actualizar.

Instala y configura la biblioteca cliente para Java

1. Descarga e instala la biblioteca cliente de Bigtable para Java más reciente. Debes tener la versión 2.16.0 o una posterior para usar las métricas del cliente.

2. 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 con la biblioteca cliente, habilita las métricas integradas. Tu código debería verse 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 y versiones posteriores, puedes inhabilitar el uso de las métricas del cliente.

BigtableDataSettings settings = BigtableDataSettings.newBuilder()
        .setProjectId("my-project")
        .setInstanceId("my-instance")
        .setMetricsProvider(NoopMetricsProvider.INSTANCE)
        .build();