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.

Trace Analytics para Amazon OpenSearch Service

Puede usar Trace Analytics, que forma parte del complemento OpenSearch Observability, para analizar los datos de rastreo de aplicaciones distribuidas. Trace Analytics requiere Elasticsearch 7.9 OpenSearch o una versión posterior.

En una aplicación distribuida, una sola operación, como un usuario que hace clic en un botón, puede desencadenar una serie extendida de eventos. Por ejemplo, el front-end de la aplicación puede llamar a un servicio backend, que llama a otro servicio, que consulta una base de datos, que procesa la consulta y devuelve un resultado. Luego, el primer servicio backend envía una confirmación al front-end, que actualiza la interfaz de usuario.

Puede utilizar Trace Analytics para ayudarle a visualizar este flujo de eventos e identificar problemas de rendimiento.

Requisitos previos

Trace Analytics requiere que añada instrumentación a su aplicación y genere datos de rastreo mediante una biblioteca OpenTelemetry compatible, como Jaeger o Zipkin. Este paso se realiza completamente fuera del Servicio. OpenSearch La AWS distribución de OpenTelemetry documentación contiene aplicaciones de ejemplo para muchos lenguajes de programación que pueden ayudarlo a comenzar, incluidos Java, Python, Go y JavaScript.

Tras añadir la instrumentación a la aplicación, el OpenTelemetryrecopilador recibe los datos de la aplicación y los formatea para OpenTelemetry convertirlos en datos. Consulte la lista de receptores en. GitHub AWS Distro for OpenTelemetry incluye un receptor para. AWS X-Ray

Por último, puede OpenSearch Ingestión de Amazon formatear esos OpenTelemetry datos para usarlos con OpenSearch.

OpenTelemetry Ejemplo de configuración del recopilador

Para usar el OpenTelemetry recopilador OpenSearch Ingestión de Amazon, pruebe el siguiente ejemplo de configuración:

extensions:
  sigv4auth:
    region: "us-east-1"
    service: "osis"
 
receivers:
  jaeger:
    protocols:
      grpc:
 
exporters:
  otlphttp:
    traces_endpoint: "https://pipeline-endpoint.us-east-1.osis.amazonaws.com/opentelemetry.proto.collector.trace.v1.TraceService/Export"
    auth:
      authenticator: sigv4auth
    compression: none
 
service:
  extensions: [sigv4auth]
  pipelines:
    traces:
      receivers: [jaeger]
      exporters: [otlphttp]

OpenSearch Ejemplo de configuración de ingestión

Para enviar datos de rastreo a un dominio de OpenSearch servicio, pruebe el siguiente ejemplo de configuración de canalización OpenSearch de ingestión. Para obtener instrucciones sobre cómo crear una canalización, consulteCreación de canalizaciones OpenSearch de Amazon Ingestion.

version: "2"
otel-trace-pipeline:
  source:
    otel_trace_source:
      "/${pipelineName}/ingest"
  processor:
    - trace_peer_forwarder:
  sink:
    - pipeline:
        name: "trace_pipeline"
    - pipeline:
        name: "service_map_pipeline"
trace-pipeline:
  source:
    pipeline:
      name: "otel-trace-pipeline"
  processor:
    - otel_traces:
  sink:
    - opensearch:
        hosts: ["https://domain-endpoint"]
        index_type: trace-analytics-raw
        aws:
          # IAM role that OpenSearch Ingestion assumes to access the domain sink   
          sts_role_arn: "arn:aws:iam::{account-id}:role/pipeline-role"
          region: "us-east-1"
        
service-map-pipeline:
  source:
    pipeline:
      name: "otel-trace-pipeline"
  processor:
    - service_map:
  sink:
    - opensearch:
        hosts: ["https://domain-endpoint"]
        index_type: trace-analytics-service-map
        aws:
          # IAM role that the pipeline assumes to access the domain sink   
          sts_role_arn: "arn:aws:iam::{account-id}:role/pipeline-role"
          region: "us-east-1"

El rol de canalización que especifique en la sts_role_arn opción debe tener permisos de escritura en el receptor. Para obtener instrucciones sobre cómo configurar los permisos para la función de canalización, consulteConfiguración de roles y usuarios en Amazon OpenSearch Ingestion.

Exploración de datos de rastreo

La vista de Panel agrupa los rastreos por método HTTP y ruta de acceso para que pueda ver la latencia media, la tasa de error y las tendencias asociadas a una operación concreta. Para obtener una vista más enfocada, intente filtrar por nombre de grupo de rastreo.

Para detallar los rastreos que componen un grupo de rastreo, elija el número de rastreos en la columna de la derecha. A continuación, elija un rastreo individual para obtener un resumen detallado.

La vista de Servicios contiene todos los servicios de la aplicación, además de un mapa interactivo que muestra cómo los distintos servicios se conectan entre sí. A diferencia del panel (que ayuda a identificar problemas por operación), el mapa de servicio le ayuda a identificar problemas por servicio. Intente ordenar por tasa de error o latencia para obtener una idea de las áreas problemáticas potenciales de su aplicación.