Etiquetado de reglas de muestreo y grupos de X-Ray - AWS X-Ray
Restricciones de las etiquetasAdministración de etiquetas en la consolaAdministrar las etiquetas en la AWS CLIControlar el acceso a los recursos de X-Ray en función de etiquetas

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.

Etiquetado de reglas de muestreo y grupos de X-Ray

Las etiquetas son palabras o frases que puedes usar para identificar y organizar tus AWS recursos. Puede agregar varias etiquetas a cada recurso. Cada etiqueta incluye una clave y un valor opcional que define el usuario. Por ejemplo, la clave de etiqueta podría ser domain y el valor de etiqueta podría ser example.com. Puede buscar y filtrar sus recursos en función de las etiquetas que añada. Para más información sobre el uso de etiquetas, consulte Etiquetado de recursos de AWS en la Guía de referencia general de AWS .

Puede usar etiquetas para imponer permisos basados en etiquetas en las CloudFront distribuciones. Para obtener más información, consulte Control de acceso a los recursos de AWS mediante etiquetas.

nota

Actualmente, ni Tag Editor ni AWS Resource Groups admiten recursos de X-Ray. Puede agregar y administrar etiquetas mediante la AWS X-Ray consola o. API

Puede aplicar etiquetas a los recursos mediante la consola X-RayAPI, AWS CLI,SDKs, y AWS Tools for Windows PowerShell. Para obtener más información, consulte la siguiente documentación sobre :

nota

Si no puede agregar o cambiar etiquetas en un recurso de X-Ray, o no puede agregar un recurso que tenga etiquetas específicas, es posible que no tenga permisos para realizar esta operación. Para solicitar acceso, póngase en contacto con un AWS usuario de su empresa que tenga permisos de administrador en X-Ray.

Restricciones de las etiquetas

Se aplican las siguientes restricciones a las etiquetas.

  • Número máximo de etiquetas por recurso: 50

  • Longitud máxima de la clave: 128 caracteres Unicode.

  • Longitud máxima del valor: 256 caracteres Unicode.

  • Valores válidos para claves y valores: a-z, A-Z, 0-9, espacio y los siguientes caracteres: _ . : / = + - y @

  • Las claves y los valores de las etiquetas distinguen entre mayúsculas y minúsculas.

  • No utilice aws: como prefijo para claves, ya que está reservado para AWS .

nota

No puede editar ni eliminar las etiquetas del sistema.

Administración de etiquetas en la consola

Puede añadir etiquetas opcionales al crear un grupo de X-Ray o una regla de muestreo. Las etiquetas también se pueden cambiar o eliminar en la consola más adelante.

En los siguientes procedimientos se explica cómo agregar, editar y eliminar etiquetas para sus grupos y reglas de muestreo en la consola X-Ray.

Agregar etiquetas a un nuevo grupo (consola)

Al crear un nuevo grupo de X-Ray, puede añadir etiquetas opcionales en la página Crear grupo.

  1. Inicie sesión en la consola de X-Ray AWS Management Console y ábrala en https://console.aws.amazon.com/xray/casa.

  2. En el panel de navegación, expanda Configuración y elija Grupos.

  3. Elija Crear grupo.

  4. En la página Crear grupo, especifique un nombre y una expresión de filtro para el grupo. Para obtener más información sobre estas propiedades, consulte Configuración de grupos.

  5. En Etiquetas, introduzca una clave de etiqueta y, si lo desea, un valor de etiqueta. Por ejemplo, puede introducir una clave de etiqueta de Stage y un valor de etiqueta de Production para indicar que este grupo es para uso en producción. Al añadir una etiqueta, aparece una nueva línea para que añada otra etiqueta, si es necesario. Consulte Restricciones de las etiquetas en este tema para conocer las limitaciones de las etiquetas.

  6. Cuando termine de agregar etiquetas, elija Crear grupo.

Agregar etiquetas a una nueva regla de muestreo (consola)

Al crear una nueva regla de muestreo de X-Ray, puede añadir etiquetas en la página Crear regla de muestreo.

  1. Inicie sesión en la consola de X-Ray AWS Management Console y ábrala en https://console.aws.amazon.com/xray/casa.

  2. En el panel de navegación, expanda Configuración y elija Muestreo.

  3. Seleccione Crear regla de muestreo.

  4. En la página Crear regla de muestreo, especifique el nombre, la prioridad, los límites, los criterios coincidentes y los atributos coincidentes. Para obtener más información sobre estas propiedades, consulte Configuración de reglas de muestreo de .

  5. En Etiquetas, introduzca una clave de etiqueta y, si lo desea, un valor de etiqueta. Por ejemplo, puede introducir una clave de etiqueta de Stage y un valor de etiqueta de Production para indicar que esta regla de muestreo es para uso en producción. Al añadir una etiqueta, aparece una nueva línea para que añada otra etiqueta, si es necesario. Consulte Restricciones de las etiquetas en este tema para conocer las limitaciones de las etiquetas.

  6. Cuando termine de agregar etiquetas, elija Crear regla de muestreo.

Edición o eliminación de etiquetas de un grupo (consola)

Puede cambiar o eliminar etiquetas de un grupo de X-Ray en la página Editar grupo.

  1. Inicie sesión en la consola de X-Ray AWS Management Console y ábrala en https://console.aws.amazon.com/xray/casa.

  2. En el panel de navegación, expanda Configuración y elija Grupos.

  3. En la tabla Grupos, elija el nombre del un grupo.

  4. En la página Editar grupo, en Etiquetas, edite las claves y los valores de las etiquetas. No puede tener claves de etiquetas duplicadas. Los valores de las etiquetas son opcionales; puede eliminarlos si lo desea. Para obtener más información sobre otras propiedades de la página Editar grupo, consulte Configuración de grupos. Consulte Restricciones de las etiquetas en este tema para conocer las limitaciones de las etiquetas.

  5. Para eliminar una etiqueta, elija X a la derecha de la etiqueta.

  6. Cuando haya terminado de editar o eliminar etiquetas, elija Actualizar grupo.

Edición o eliminación de etiquetas de una regla de muestreo (consola)

Puede cambiar o eliminar las etiquetas de una regla de muestreo de X-Ray en la página Editar regla de muestreo.

  1. Inicie sesión en la consola de X-Ray AWS Management Console y ábrala en https://console.aws.amazon.com/xray/casa.

  2. En el panel de navegación, expanda Configuración y elija Muestreo.

  3. En la tabla Reglas de muestreo, elija el nombre de una regla de muestreo.

  4. En Etiquetas, edite las claves y los valores de las etiquetas. No puede tener claves de etiquetas duplicadas. Los valores de las etiquetas son opcionales; puede eliminarlos si lo desea. Para obtener más información sobre otras propiedades de la página Editar regla de muestreo, consulte Configuración de reglas de muestreo de . Consulte Restricciones de las etiquetas en este tema para conocer las limitaciones de las etiquetas.

  5. Para eliminar una etiqueta, elija X a la derecha de la etiqueta.

  6. Cuando haya terminado de editar o eliminar etiquetas, elija Actualizar regla de muestreo.

Administrar las etiquetas en la AWS CLI

Puede añadir etiquetas al crear un grupo o una regla de muestreo de X-Ray. También puede utilizar el AWS CLI para crear y administrar etiquetas. Para actualizar las etiquetas de un grupo o regla de muestreo existente, utilice la AWS X-Ray consola o la tecla TagResourceo UntagResourceAPIs.

Añadir etiquetas a un nuevo grupo de rayos X o regla de muestreo (CLI)

Para añadir etiquetas opcionales al crear un nuevo grupo o una nueva regla de muestreo de X-Ray, utilice uno de los siguientes comandos.

  • Para añadir etiquetas a un grupo nuevo, ejecute el siguiente comando, sustituyendo group_name con el nombre de tu grupo, mydomain.com con el punto final de su servicio, key_name con una clave de etiqueta y, opcionalmente, value con un valor de etiqueta. Para obtener más información sobre cómo crear un grupo, consulte Grupos.

    aws xray create-group \
   --group-name "group_name" \
   --filter-expression "service(\"mydomain.com\") {fault OR error}" \
   --tags [{"Key": "key_name","Value": "value"},{"Key": "key_name","Value": "value"}]

    A continuación, se muestra un ejemplo.

    aws xray create-group \
   --group-name "AdminGroup" \
   --filter-expression "service(\"mydomain.com\") {fault OR error}" \
   --tags [{"Key": "Stage","Value": "Prod"},{"Key": "Department","Value": "QA"}]

  • Para añadir etiquetas a una nueva regla de muestreo, ejecute el siguiente comando, sustituyendo key_name con una clave de etiqueta y, opcionalmente, value con un valor de etiqueta. Este comando especifica los valores del --sampling-rule parámetro en forma de JSON archivo. Para obtener más información sobre cómo crear una regla de muestreo, consulte Reglas de muestreo.

    aws xray create-sampling-rule \
   --cli-input-json file://file_name.json

    El siguiente es el contenido del JSON archivo file_name.json que se especifica en el --cli-input-json parámetro.

    {
    "SamplingRule": {
        "RuleName": "rule_name",
        "RuleARN": "string",
        "ResourceARN": "string",
        "Priority": integer,
        "FixedRate": double,
        "ReservoirSize": integer,
        "ServiceName": "string",
        "ServiceType": "string",
        "Host": "string",
        "HTTPMethod": "string",
        "URLPath": "string",
        "Version": integer,
        "Attributes": {"attribute_name": "value","attribute_name": "value"...}
    }
    "Tags": [
           {
               "Key":"key_name",
               "Value":"value"
           },
           {
               "Key":"key_name",
               "Value":"value"
           }
          ]
}

    El siguiente comando es un ejemplo.

    aws xray create-sampling-rule \
   --cli-input-json file://9000-base-scorekeep.json

    A continuación puede ver el contenido del archivo de ejemplo 9000-base-scorekeep.json especificado por el parámetro --cli-input-json.

    {
    "SamplingRule": {
        "RuleName": "base-scorekeep",
        "ResourceARN": "*",
        "Priority": 9000,
        "FixedRate": 0.1,
        "ReservoirSize": 5,
        "ServiceName": "Scorekeep",
        "ServiceType": "*",
        "Host": "*",
        "HTTPMethod": "*",
        "URLPath": "*",
        "Version": 1
    }
    "Tags": [
           {
               "Key":"Stage",
               "Value":"Prod"
           },
           {
               "Key":"Department",
               "Value":"QA"
           }
          ]
}

Añadir etiquetas a un recurso existente (CLI)

Puede ejecutar el comando tag-resource para añadir etiquetas a un grupo o una regla de muestreo de X-Ray existente. Este método puede resultar más sencillo que añadir etiquetas ejecutando update-group o update-sampling-rule.

Para añadir etiquetas a un grupo o a una regla de muestreo, ejecute el siguiente comando, ARN sustituya el por el ARN del recurso y especifique las claves y los valores opcionales de las etiquetas que desee añadir.

aws xray tag-resource \
   --resource-arn "ARN" \
   --tag-keys [{"Key":"key_name","Value":"value"}, {"Key":"key_name","Value":"value"}]

A continuación, se muestra un ejemplo.

aws xray tag-resource \
   --resource-arn "arn:aws:xray:us-east-2:01234567890:group/AdminGroup" \
   --tag-keys [{"Key": "Stage","Value": "Prod"},{"Key": "Department","Value": "QA"}]

Enumere las etiquetas de un recurso (CLI)

Puede ejecutar el comando list-tags-for-resource para ver una lista de las etiquetas de un grupo o una regla de muestreo de X-Ray.

Para enumerar las etiquetas asociadas a un grupo o a una regla de muestreo, ejecute el siguiente comando y ARN sustituya el por el ARN del recurso.

aws xray list-tags-for-resource \
   --resource-arn "ARN"

A continuación, se muestra un ejemplo.

aws xray list-tags-for-resource \
   --resource-arn "arn:aws:xray:us-east-2:01234567890:group/AdminGroup"

Eliminar etiquetas de un recurso (CLI)

Puede ejecutar el comando untag-resource para eliminar las etiquetas de un grupo o una regla de muestreo de X-Ray.

Para eliminar etiquetas de un grupo o una regla de muestreo, ejecute el siguiente comando, ARN sustituya la por la ARN del recurso y especifique las claves de las etiquetas que desea eliminar.

Con el comando untag-resource solo puede eliminar etiquetas enteras. Para eliminar los valores de las etiquetas, utilice la consola de X-Ray o elimine las etiquetas y añada otras nuevas con las mismas claves pero con valores diferentes o vacíos.

aws xray untag-resource \
   --resource-arn "ARN" \
   --tag-keys ["key_name","key_name"]

A continuación, se muestra un ejemplo.

aws xray untag-resource \
   --resource-arn "arn:aws:xray:us-east-2:01234567890:group/group_name" \
   --tag-keys ["Stage","Department"]

Controlar el acceso a los recursos de X-Ray en función de etiquetas

Puede adjuntar etiquetas a los grupos o las reglas de muestreo de X-Ray, o pasar las etiquetas en una solicitud a X-Ray. Para controlar el acceso en función de etiquetas, debe proporcionar información de las etiquetas en el elemento de condición de una política utilizando las claves de condición xray:ResourceTag/key-name, aws:RequestTag/key-name o aws:TagKeys. Para obtener más información sobre estas claves de condición, consulte Controlar el acceso a AWS los recursos mediante etiquetas de recursos.

Para consultar un ejemplo de política basada en la identidad para limitar el acceso a un recurso en función de las etiquetas de ese recurso, consulte Gestión del acceso a los grupos de rayos X y a las reglas de muestreo en función de las etiquetas.