Habilitación de Transaction Search - Amazon CloudWatch
Habilitación de Transaction Search en la consolaHabilitación de Transaction Search con una API

Habilitación de Transaction Search

Puede habilitar Transaction Search con la consola o una API. La búsqueda de transacciones está configurada para toda la cuenta y cambia la ingesta de todas las unidades mediante X-Ray al modo de recopilación rentable usando Precios de Amazon CloudWatch. De forma predeterminada, también indexará el 1 % de las unidades ingeridas de forma gratuita como resumen de seguimiento para su análisis, lo que suele ser suficiente dado que ya dispone de una visibilidad completa de seguimiento de principio a fin en todas las unidades ingeridas mediante la búsqueda de transacciones.

Habilitación de Transaction Search en la consola

En el procedimiento siguiente se describe cómo habilitar Transaction Search en la consola.

Habilitación de Transaction Search en la consola de CloudWatch

  1. Abra la consola de CloudWatch en https://console.aws.amazon.com/cloudwatch/.

  2. En el panel de navegación, en Application Signals, elija Transaction Search.

  3. Seleccione Habilitar Transaction Search.

  4. Seleccione la casilla para ingerir las unidades de seguimiento como registros estructurados e introduzca un porcentaje de las unidades de seguimiento que desee indexar. Puede indexar las piezas de registro al 1 % de forma gratuita y cambiar el porcentaje más adelante en función de sus necesidades.

Habilitación de Transaction Search con una API

En el siguiente procedimiento se describe cómo habilitar Transaction Search con una API.

Paso 1. Creación de una política que conceda acceso para ingerir unidades de seguimiento en Registros de CloudWatch

Cuando utilice la AWS CLI o el SDK para habilitar Transaction Search, debe configurar los permisos mediante una política basada en recursos con PutResourcePolicy.

Ejemplo de política de

El siguiente ejemplo de política permite a X-Ray enviar seguimientos a Registros de CloudWatch. 

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "TransactionSearchXRayAccess",
            "Effect": "Allow",
            "Principal": {
                "Service": "xray.amazonaws.com"
            },
            "Action": "logs:PutLogEvents",
            "Resource": [
                "arn:partition:logs:region:account-id:log-group:aws/spans:*",
                "arn:partition:logs:region:account-id:log-group:/aws/application-signals/data:*"
            ],
            "Condition": {
                "ArnLike": {
                    "aws:SourceArn": "arn:partition:xray:region:account-id:*"
                },
                "StringEquals": {
                    "aws:SourceAccount": "account-id"
                }
            }
        }
    ]
}
Comando de ejemplo:

En el siguiente ejemplo se muestra cómo formatear el comando AWS CLI con PutResourcePolicy. 

aws logs put-resource-policy --policy-name MyResourcePolicy --policy-document '{ "Version": "2012-10-17", "Statement": [ { "Sid": "TransactionSearchXRayAccess", "Effect": "Allow", "Principal": { "Service": "xray.amazonaws.com" }, "Action": "logs:PutLogEvents", "Resource": [ "arn:partition:logs:region:account-id:log-group:aws/spans:*", "arn:partition:logs:region:account-id:log-group:/aws/application-signals/data:*" ], "Condition": { "ArnLike": { "aws:SourceArn": "arn:partition:logs:region:account-id:*" }, "StringEquals": { "aws:SourceAccount": "account-id" } } } ]}'

Paso 2. Configuración del destino de los segmentos de seguimientos

Configure la ingesta de unidades de seguimiento con UpdateTraceSegmentDestination.

Comando de ejemplo:

En el siguiente ejemplo se muestra cómo formatear el comando AWS CLI con UpdateTraceSegmentDestination. 

aws xray update-trace-segment-destination --destination CloudWatchLogs

Paso 3. Configuración de la cantidad de unidades de seguimiento que se van a indexar

Configuración del porcentaje de muestreo deseado con UpdateIndexingRule

Comando de ejemplo:

En el siguiente ejemplo se muestra cómo formatear el comando AWS CLI con UpdateIndexingRule. 

aws xray update-indexing-rule --name "Default" --rule '{"Probabilistic": {"DesiredSamplingPercentage": number}}'
nota

Tras activar Transaction Search, las unidades de seguimiento pueden tardar diez minutos en estar disponibles para su búsqueda y análisis.

Paso 4. Verificación de que las unidades de seguimiento estén disponibles para la búsqueda y el análisis

Para verificar que las unidades de seguimiento estén disponibles para la búsqueda y el análisis, use GetTraceSegmentDestination.

Comandos de ejemplo

En el siguiente ejemplo se muestra cómo formatear el comando AWS CLI con GetTraceSegmentDestination. 

aws xray get-trace-segment-destination
Ejemplo de respuesta

En el siguiente ejemplo, se muestra la respuesta que puede esperar cuando Transaction Search esté activo. 

{
    "Destination": "CloudWatchLogs",
    "Status": "ACTIVE"
}