As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Configurar grupos
Os grupos são uma coleção de rastreamentos definidos por uma expressão de filtro. Você pode usar grupos para gerar gráficos de serviço adicionais e fornecer métricas do Amazon CloudWatch. Você pode usar o console do AWS X-Ray ou a API do X-Ray para criar e gerenciar grupos para seus serviços. Este tópico descreve como criar e gerenciar grupos usando o console do X-Ray. Para obter informações sobre como gerenciar grupos usando a API do X-Ray, consulte [Groups (Grupos)](xray-api-configuration.md#xray-api-configuration-groups).
Você pode criar grupos de rastreamentos para mapas de rastreamento, rastreamentos ou análises. Ao criar um grupo, ele fica disponível como um filtro no menu suspenso do grupo em todas as três páginas: **Mapa de rastreamento**, **Rastreamentos** e **Análises**.
![\[Menu de grupos\]](http://docs.aws.amazon.com/pt_br/xray/latest/devguide/images/group-menu.png)
Os grupos são identificados pelo nome ou pelo nome do recurso da Amazon (ARN) e contêm uma expressão de filtro. O serviço compara os rastreamentos de entrada com a expressão e os armazena adequadamente. Para obter mais informações sobre como criar uma expressão de filtro, consulte [Usar expressões de filtro](xray-console-filters.md).
Atualizar a expressão de filtro de um grupo não altera os dados que já estão registrados. A atualização se aplica somente aos rastreamentos subsequentes. Isso pode resultar em um gráfico mesclado das expressões novas e antigas. Para evitar isso, exclua o grupo atual e crie outro.
**nota**
Os grupos são faturados pelo número de rastreamentos recuperados que correspondem à expressão de filtro. Para obter mais informações, consulte [Preços do AWS X-Ray](https://aws.amazon.com/xray/pricing/).
**Topics**
+ [Criar um grupo](#xray-console-group-create-console)
+ [Aplicar um grupo](#xray-console-group-apply)
+ [Editar um grupo](#xray-console-group-edit)
+ [Clonar um grupo](#xray-console-group-clone)
+ [Excluir um grupo](#xray-console-group-delete)
+ [Visualizar métricas de grupo no Amazon CloudWatch](#xray-console-group-cloudwatch)
## Criar um grupo
**nota**
Agora você pode configurar as regras de amostragem do X-Ray no console do Amazon CloudWatch. Você também pode continuar usando o console do X-Ray.
------
#### [ CloudWatch console ]
1. Faça login no Console de gerenciamento da AWS e abra o console do CloudWatch em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Escolha **Configurações** no painel de navegação à esquerda.
1. Escolha **Visualizar configurações** em **Grupos** na seção **Rastreamentos do X-Ray**.
1. Escolha **Criar grupo** acima da lista de grupos.
1. Na página **Criar grupo**, digite um nome para o grupo. O nome de grupo pode ter no máximo 32 caracteres, mas somente caracteres alfanuméricos e hifens. Os nomes de grupo diferenciam letras maiúsculas de minúsculas.
1. Insira uma expressão de filtro. Para obter mais informações sobre como criar uma expressão de filtro, consulte [Usar expressões de filtro](xray-console-filters.md). No exemplo a seguir, o grupo filtra os rastreamentos de falhas do serviço `api.example.com` e as solicitações ao serviço em que o tempo de resposta foi maior ou igual a cinco segundos.
```
fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5
```
1. Em **Insights**, habilite ou desabilite o acesso a insights para o grupo. Para obter mais informações sobre insights, consulte [Usar os insights do X-Ray](xray-console-insights.md).
![\[Caixas de seleção Insights na página do grupo\]](http://docs.aws.amazon.com/pt_br/xray/latest/devguide/images/group-insights-cw.png)
1. Em **Tags**, escolha **Adicionar nova tag** para inserir uma chave de tag e, opcionalmente, um valor de tag. Continue adicionando outras tags conforme desejado. As chaves de tag devem ser exclusivas. Para excluir uma tag, escolha **Remover** abaixo de cada tag. Para obter mais informações sobre tags, consulte [Marcar grupos e regras de amostragem do X-Ray](xray-tagging.md).
![\[Campos de tag na página Grupo\]](http://docs.aws.amazon.com/pt_br/xray/latest/devguide/images/group-tags-cw.png)
1. Escolha **Criar grupo**.
------
#### [ X-Ray console ]
1. Faça login no Console de gerenciamento da AWS e abra o console do X-Ray em [https://console.aws.amazon.com/xray/home](https://console.aws.amazon.com/xray/home).
1. Abra a página **Criar grupo** na página **Grupos** no painel de navegação esquerdo ou no menu de grupos em uma das seguintes páginas: **Mapa de rastreamento**, **Rastreamentos** e **Análises**.
1. Na página **Criar grupo**, digite um nome para o grupo. O nome de grupo pode ter no máximo 32 caracteres, mas somente caracteres alfanuméricos e hifens. Os nomes de grupo diferenciam letras maiúsculas de minúsculas.
1. Insira uma expressão de filtro. Para obter mais informações sobre como criar uma expressão de filtro, consulte [Usar expressões de filtro](xray-console-filters.md). No exemplo a seguir, o grupo filtra os rastreamentos de falhas do serviço `api.example.com` e as solicitações ao serviço em que o tempo de resposta foi maior ou igual a cinco segundos.
```
fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5
```
1. Em **Insights**, habilite ou desabilite o acesso a insights para o grupo. Para obter mais informações sobre insights, consulte [Usar os insights do X-Ray](xray-console-insights.md).
![\[Caixas de seleção Insights na página do grupo\]](http://docs.aws.amazon.com/pt_br/xray/latest/devguide/images/group-insights.png)
1. Em **Tags**, insira uma chave de tag e, opcionalmente, um valor de tag. Ao adicionar uma tag, uma nova linha aparece para você adicionar outra tag. As chaves de tag devem ser exclusivas. Para excluir uma tag, escolha **X** no final da linha da tag. Para obter mais informações sobre tags, consulte [Marcar grupos e regras de amostragem do X-Ray](xray-tagging.md).
![\[Campos de tag na página Grupo\]](http://docs.aws.amazon.com/pt_br/xray/latest/devguide/images/group-tags.png)
1. Escolha **Criar grupo**.
------
## Aplicar um grupo
------
#### [ CloudWatch console ]
1. Faça login no Console de gerenciamento da AWS e abra o console do CloudWatch em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Abra uma das páginas a seguir no painel de navegação em **Rastreamentos do X-Ray**:
+ **Mapa de rastreamento**
+ **Rastreamentos**
1. Insira um nome de grupo no filtro **Filtrar por grupo do X-Ray**. Os dados mostrados na página são alterados para corresponder à expressão de filtro definida no grupo.
------
#### [ X-Ray console ]
1. Faça login no Console de gerenciamento da AWS e abra o console do X-Ray em [https://console.aws.amazon.com/xray/home](https://console.aws.amazon.com/xray/home).
1. Abra uma das seguintes páginas no painel de navegação:
+ **Mapa de rastreamento**
+ **Rastreamentos**
+ **Analytics**
1. No menu de grupos, escolha o grupo em que você criou em [Criar um grupo](#xray-console-group-create-console). Os dados mostrados na página são alterados para corresponder à expressão de filtro definida no grupo.
------
## Editar um grupo
------
#### [ CloudWatch console ]
1. Faça login no Console de gerenciamento da AWS e abra o console do CloudWatch em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Escolha **Configurações** no painel de navegação à esquerda.
1. Escolha **Visualizar configurações** em **Grupos** na seção **Rastreamentos do X-Ray**.
1. Escolha um grupo na seção **Grupos** e selecione **Editar**.
1. Embora não seja possível renomear um grupo, você pode atualizar a expressão de filtro. Para obter mais informações sobre como criar uma expressão de filtro, consulte [Usar expressões de filtro](xray-console-filters.md). No exemplo a seguir, o grupo filtra rastreamentos de falha do serviço `api.example.com` em que o endereço do URL da solicitação contém `example/game` e o tempo de resposta para solicitações foi maior ou igual a cinco segundos.
```
fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5
```
1. Em **Insights**, habilite ou desabilite o acesso a insights para o grupo. Para obter mais informações sobre insights, consulte [Usar os insights do X-Ray](xray-console-insights.md).
![\[Caixas de seleção Insights na página do grupo\]](http://docs.aws.amazon.com/pt_br/xray/latest/devguide/images/group-insights-cw.png)
1. Em **Tags**, escolha **Adicionar nova tag** para inserir uma chave de tag e, opcionalmente, um valor de tag. Continue adicionando outras tags conforme desejado. As chaves de tag devem ser exclusivas. Para excluir uma tag, escolha **Remover** abaixo de cada tag. Para obter mais informações sobre tags, consulte [Marcar grupos e regras de amostragem do X-Ray](xray-tagging.md).
![\[Campos de tag na página Grupo\]](http://docs.aws.amazon.com/pt_br/xray/latest/devguide/images/group-tags-cw.png)
1. Quando terminar de atualizar o grupo, escolha **Atualizar grupo**.
------
#### [ X-Ray console ]
1. Faça login no Console de gerenciamento da AWS e abra o console do X-Ray em [https://console.aws.amazon.com/xray/home](https://console.aws.amazon.com/xray/home).
1. Realize uma das seguintes ações para abrir a página **Editar grupo**:
1. Na página **Grupos**, escolha o nome de um grupo para editá-lo.
1. No menu de grupos em uma das páginas a seguir, aponte para um grupo e escolha **Editar**.
+ **Mapa de rastreamento**
+ **Rastreamentos**
+ **Analytics**
1. Embora não seja possível renomear um grupo, você pode atualizar a expressão de filtro. Para obter mais informações sobre como criar uma expressão de filtro, consulte [Usar expressões de filtro](xray-console-filters.md). No exemplo a seguir, o grupo filtra rastreamentos de falha do serviço `api.example.com` em que o endereço do URL da solicitação contém `example/game` e o tempo de resposta para solicitações foi maior ou igual a cinco segundos.
```
fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5
```
1. Em **Insights**, habilite ou desabilite os insights e as notificações de insights para o grupo. Para obter mais informações sobre insights, consulte [Usar os insights do X-Ray](xray-console-insights.md).
![\[Caixas de seleção Insights na página do grupo\]](http://docs.aws.amazon.com/pt_br/xray/latest/devguide/images/group-insights.png)
1. Em **Tags**, edite chaves e valores da tag. As chaves de tag devem ser exclusivas. Os valores das tags são opcionais; você pode excluir valores se quiser. Para excluir uma tag, escolha **X** no final da linha da tag. Para obter mais informações sobre tags, consulte [Marcar grupos e regras de amostragem do X-Ray](xray-tagging.md).
![\[Campos de tag na página Grupo\]](http://docs.aws.amazon.com/pt_br/xray/latest/devguide/images/group-tags.png)
1. Quando terminar de atualizar o grupo, escolha **Atualizar grupo**.
------
## Clonar um grupo
A clonagem de um grupo cria um grupo com a expressão de filtro e as tags de um grupo existente. Quando você clona um grupo, o novo tem o mesmo nome do grupo do qual ele foi clonado, com `-clone` anexado ao nome.
------
#### [ CloudWatch console ]
1. Faça login no Console de gerenciamento da AWS e abra o console do CloudWatch em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Escolha **Configurações** no painel de navegação à esquerda.
1. Escolha **Visualizar configurações** em **Grupos** na seção **Rastreamentos do X-Ray**.
1. Escolha um grupo na seção **Grupos** e selecione **Clonar**.
1. Na página **Criar grupo**, o nome do grupo é *group-name*`-clone`. Opcionalmente, insira um novo nome para o grupo. O nome de grupo pode ter no máximo 32 caracteres, mas somente caracteres alfanuméricos e hifens. Os nomes de grupo diferenciam letras maiúsculas de minúsculas.
1. Você pode manter a expressão de filtro do grupo ou, opcionalmente, inserir uma nova expressão de filtro. Para obter mais informações sobre como criar uma expressão de filtro, consulte [Usar expressões de filtro](xray-console-filters.md). No exemplo a seguir, o grupo filtra os rastreamentos de falhas do serviço `api.example.com` e as solicitações ao serviço em que o tempo de resposta foi maior ou igual a cinco segundos.
```
service("api.example.com") { fault = true OR responsetime >= 5 }
```
1. Em **Tags**, edite chaves e valores da tag, se necessário. As chaves de tag devem ser exclusivas. Os valores das tags são opcionais; você pode excluir valores se quiser. Para excluir uma tag, escolha **X** no final da linha da tag. Para obter mais informações sobre tags, consulte [Marcar grupos e regras de amostragem do X-Ray](xray-tagging.md).
1. Escolha **Criar grupo**.
------
#### [ X-Ray console ]
1. Faça login no Console de gerenciamento da AWS e abra o console do X-Ray em [https://console.aws.amazon.com/xray/home](https://console.aws.amazon.com/xray/home).
1. Abra a página **Grupos** no painel de navegação esquerdo e escolha o nome de um grupo que você deseja clonar.
1. No menu **Ações**, escolha **Clonar grupo**.
1. Na página **Criar grupo**, o nome do grupo é *group-name*`-clone`. Opcionalmente, insira um novo nome para o grupo. O nome de grupo pode ter no máximo 32 caracteres, mas somente caracteres alfanuméricos e hifens. Os nomes de grupo diferenciam letras maiúsculas de minúsculas.
1. Você pode manter a expressão de filtro do grupo ou, opcionalmente, inserir uma nova expressão de filtro. Para obter mais informações sobre como criar uma expressão de filtro, consulte [Usar expressões de filtro](xray-console-filters.md). No exemplo a seguir, o grupo filtra os rastreamentos de falhas do serviço `api.example.com` e as solicitações ao serviço em que o tempo de resposta foi maior ou igual a cinco segundos.
```
service("api.example.com") { fault = true OR responsetime >= 5 }
```
1. Em **Tags**, edite chaves e valores da tag, se necessário. As chaves de tag devem ser exclusivas. Os valores das tags são opcionais; você pode excluir valores se quiser. Para excluir uma tag, escolha **X** no final da linha da tag. Para obter mais informações sobre tags, consulte [Marcar grupos e regras de amostragem do X-Ray](xray-tagging.md).
1. Escolha **Criar grupo**.
------
## Excluir um grupo
Siga as etapas nesta seção para excluir um grupo. Não é possível excluir o grupo **padrão**.
------
#### [ CloudWatch console ]
1. Faça login no Console de gerenciamento da AWS e abra o console do CloudWatch em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Escolha **Configurações** no painel de navegação à esquerda.
1. Escolha **Visualizar configurações** em **Grupos** na seção **Rastreamentos do X-Ray**.
1. Escolha um grupo na seção **Grupos** e selecione **Excluir**.
1. Quando for solicitada sua confirmação, escolha **Excluir**.
------
#### [ X-Ray console ]
1. Faça login no Console de gerenciamento da AWS e abra o console do X-Ray em [https://console.aws.amazon.com/xray/home](https://console.aws.amazon.com/xray/home).
1. Abra a página **Grupos** no painel de navegação esquerdo e escolha o nome de um grupo que você deseja excluir.
1. No menu **Ações**, escolha **Excluir grupo**.
1. Quando for solicitada sua confirmação, escolha **Excluir**.
------
## Visualizar métricas de grupo no Amazon CloudWatch
Assim que um grupo é criado, os rastreamentos de entrada são verificados em relação à expressão de filtro do grupo, pois são armazenados no serviço X-Ray. As métricas referentes à quantidade de rastreamentos correspondentes a cada critério são publicadas no Amazon CloudWatch a cada minuto. Escolher **Exibir métricas** na página **Editar grupo** abre o console do CloudWatch na página **Métrica**. Para obter mais informações sobre como usar métricas do CloudWatch, consulte [Usar métricas do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html) no *Guia do usuário do Amazon CloudWatch*.
------
#### [ CloudWatch console ]
1. Faça login no Console de gerenciamento da AWS e abra o console do CloudWatch em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Escolha **Configurações** no painel de navegação à esquerda.
1. Escolha **Visualizar configurações** em **Grupos** na seção **Rastreamentos do X-Ray**.
1. Escolha um grupo na seção **Grupos** e selecione **Editar**.
1. Na página **Editar grupo** escolha **Exibir métrica**.
A página **Métricas** do console do CloudWatch é aberta em uma nova guia.
------
#### [ X-Ray console ]
1. Faça login no Console de gerenciamento da AWS e abra o console do X-Ray em [https://console.aws.amazon.com/xray/home](https://console.aws.amazon.com/xray/home).
1. Abra a página **Grupos** no painel de navegação esquerdo e escolha o nome de um grupo do qual você deseja visualizar as métricas.
1. Na página **Editar grupo** escolha **Exibir métrica**.
A página **Métricas** do console do CloudWatch é aberta em uma nova guia.
------