Application Real-Time Monitoring Service:Enable tracing for NGINX Ingress Controller

Paso 2: Habilitar OpenTelemetry en NGINX Ingress ControllerManaged Service for OpenTelemetry

1. Inicie sesión en la consola de ACK. En el panel de navegación izquierdo, haga clic en Clusters.

2. En la página Clusters, haga clic en el nombre de su clúster. En el panel de navegación izquierdo, haga clic en Workloads > Deployments.

3. En la página Deployments, establezca el Namespace en kube-system. Busque el despliegue nginx-ingress-controller y haga clic en Edit en la columna Actions.

4. En la página Edit, seleccione el contenedor nginx-ingress-controller. En la pestaña Environment Variable, haga clic en Add para agregar la siguiente variable de entorno.

   Type	Variable name	Value	Descripción
   Custom	OTEL_EXPORTER_OTLP_HEADERS	authentication=<authentication token>	Utilice el token de autenticación que obtuvo en Step 1: Obtain endpoint information. Ejemplo: authentication=bfXXXXXXXe@7bXXXXXXX1_bXXXXXe@XXXXXXX1.

   Una vez completada la adición, haga clic en Update en el lado derecho de la página Edit y, a continuación, haga clic en OK en el cuadro de diálogo que aparece.

5. En el panel de navegación izquierdo, elija Configuration > ConfigMaps.

6. En la página ConfigMaps, establezca el Namespace en kube-system. Busque el ConfigMap nginx-configuration y haga clic en Edit en la columna Actions.

7. En el panel Edit, haga clic en Add para agregar los siguientes pares clave-valor y, a continuación, haga clic en OK.

   Parámetro	Descripción	Valor	Ejemplo
   enable-opentelemetry	Especifica si se habilita el rastreo de OpenTelemetry.	true: Habilita el rastreo. false: Deshabilita el rastreo.	true
   main-snippet	-	env OTEL_EXPORTER_OTLP_HEADERS;	env OTEL_EXPORTER_OTLP_HEADERS;
   otel-service-name	El nombre del servicio.	Un nombre personalizado.	nginx-ingress
   otlp-collector-host	El nombre de dominio del endpoint de reporte gRPC.	Utilice el endpoint de red VPC que obtuvo en Step 1: Obtain endpoint information. Elimine el prefijo http:// y el número de puerto. Ejemplo: tracing-analysis-XX-XX-XXXXX.aliyuncs.com.	tracing-analysis-XX-XX-XXXXX.aliyuncs.com
   otlp-collector-port	El puerto del endpoint de reporte gRPC.	El número de puerto real.	8090
   opentelemetry-trust-incoming-span	Especifica si se confía en las trazas entrantes de otros servicios o sistemas.	true: Confía en las trazas entrantes. false: No confía en las trazas entrantes.	true
   opentelemetry-operation-name	El formato del span de la traza.	HTTP $request_method $service_name $uri	HTTP $request_method $service_name $uri
   otel-sampler	La regla de muestreo.	Para obtener más información, consulte la documentación de NGINX Ingress Controller.	TraceIdRatioBased
   otel-sampler-ratio	La tasa de muestreo.	Un valor de 0.0 a 1.0, con hasta dos decimales. Un valor de 0.0 deshabilita el muestreo, mientras que 1.0 muestrea cada traza. Para obtener más información, consulte la documentación de NGINX Ingress Controller.	0.1
   otel-sampler-parent-based	Especifica si se hereda la decisión de muestreo del servicio ascendente.	false: (Predeterminado) No hereda la decisión de muestreo ascendente. Los parámetros otel-sampler y otel-sampler-ratio surten efecto. true: Hereda y reutiliza la decisión de muestreo ascendente. Los parámetros otel-sampler y otel-sampler-ratio no surten efecto. Para obtener más información, consulte la documentación de NGINX Ingress Controller.	false

Paso 1: Obtener la información del endpoint

1. Inicie sesión en la consola de ARMS. En el panel de navegación izquierdo, haga clic en Integration Center.

2. En el área Server-side Applications, haga clic en la tarjeta Zipkin.

   Nota

   Este ejemplo utiliza Zipkin.

3. En el panel Zipkin que aparece, seleccione la región donde desea reportar los datos.

4. Registre la información del endpoint. Para Connection Method, seleccione Alibaba Cloud Intranet. La página muestra dos URL de endpoints de red VPC: un v2 endpoint y un v1 endpoint. Copie la URL del v1 endpoint para usarla más adelante.

   Nota

   Utilice el endpoint de red VPC si su NGINX Ingress Controller está desplegado en la misma región de Alibaba Cloud que Managed Service for OpenTelemetry. De lo contrario, utilice el endpoint público.

Paso 2: Habilitar OpenTracing en NGINX Ingress ControllerManaged Service for OpenTelemetry

1. Inicie sesión en la consola de ACK. En el panel de navegación izquierdo, haga clic en Clusters.

2. En la página Clusters, haga clic en el nombre de su clúster. En el panel de navegación izquierdo, haga clic en Configurations > ConfigMaps.

3. En la página ConfigMaps, establezca el Namespace en kube-system. Busque el ConfigMap nginx-configuration y haga clic en Actions en la columna Edit.

4. En el panel Edit, haga clic en Add para agregar los siguientes pares clave-valor y, a continuación, haga clic en OK.

   Parámetro	Descripción	Valor	Ejemplo
   enable-opentracing	Especifica si se habilita el rastreo.	true: Habilita el rastreo. false: Deshabilita el rastreo.	true
   zipkin-service-name	El nombre del servicio.	Un nombre personalizado.	nginx-ingress
   zipkin-collector-host	El nombre de dominio del endpoint de reporte.	Modifique la URL del endpoint que obtuvo en Step 1: Obtain endpoint information. Elimine el prefijo http:// y agregue un signo de interrogación (?) al final. Por ejemplo: Endpoint original: http://tracing-analysis-dc-hz-internal.aliyuncs.com/adapt__/api/v1/spans. Valor modificado: tracing-analysis-dc-hz-internal.aliyuncs.com/adapt__/api/v1/spans?.	tracing-analysis-dc-hz-internal.aliyuncs.com/adapt__/api/v1/spans?
   opentracing-trust-incoming-span	Especifica si se confía en las trazas entrantes de otros servicios o sistemas.	true: Confía en las trazas entrantes. false: No confía en las trazas entrantes.	true
   zipkin-sample-rate	La tasa de muestreo.	Un valor de 0 a 1, con hasta dos decimales. Un valor de 0 significa que no hay muestreo, y 1 significa que se muestrean todos los datos.	0.1

Paso 3: Consultar las trazas en la consola de ARMS