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. Las etiquetas se agregan y administran mediante la AWS X-Ray consola o la API.

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

• API de X-Ray: consulte las siguientes operaciones en la referencia de la API de AWS X-Ray :

  • ListTagsForResource

  • CreateSamplingRule

  • CreateGroup

  • TagResource

  • UntagResource

• AWS CLI — Consulte la radiografía en la Referencia de comandos AWS CLI

• SDK: consulte la documentación del SDK correspondiente en la página Documentación de AWS.

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.

Temas

• Agregar etiquetas a un nuevo grupo (consola)
• Agregar etiquetas a una nueva regla de muestreo (consola)
• Edición o eliminación de etiquetas de un grupo (consola)
• Edición o eliminación de etiquetas de una regla de muestreo (consola)

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/home.

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 Configure 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/home.

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 Configure las reglas de muestreo.

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/home.

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 Configure 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/home.

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 Configure las reglas de muestreo. 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 el 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, usa la AWS X-Ray consola TagResourceo las UntagResourceAPI.

Temas

• Agregar etiquetas a un nuevo grupo de o regla de muestreo de X-Ray (CLI)
• Añadir etiquetas a un recurso existente (CLI)
• Visualizar las etiquetas de un recurso (CLI)
• Eliminar etiquetas de un recurso (CLI)

Agregar etiquetas a un nuevo grupo de o regla de muestreo de X-Ray (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 nuevo grupo, ejecute el siguiente comando y sustituya group_name por el nombre de su grupo, mydomain.com por el punto de conexión de su servicio, key_name por una clave de etiqueta y, si lo desea, value por un valor de etiqueta. Para obtener más información sobre cómo crear un grupo, consulte Configuración de los ajustes de muestreo, grupos y cifrado con la API X-Ray.

  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 y sustituya key_name por una clave de etiqueta y, si lo desea, value por un valor de etiqueta. Este comando especifica los valores del parámetro --sampling-rule como archivo JSON. Para obtener más información sobre cómo crear una regla de muestreo, consulte Configuración de los ajustes de muestreo, grupos y cifrado con la API X-Ray.

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

  A continuación puede ver el contenido del archivo JSON file_name.json especificado por el parámetro --cli-input-json.

  {
      "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 agregar etiquetas a un grupo o a una regla de muestreo, ejecute el siguiente comando, sustituyendo el ARN por el ARN del recurso y especificando las claves y los valores opcionales de las etiquetas que desee agregar.

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"}]

Visualizar 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 ver una lista de las etiquetas asociadas a un grupo o una regla de muestreo, ejecute el siguiente comando sustituyendo el ARN 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 agregar etiquetas de un grupo o de una regla de muestreo, ejecute el siguiente comando, sustituyendo el ARN por el ARN del recurso y especificando las claves de las etiquetas que desee 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.