> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Link templates

O AppSignal suporta taggear requisições, conforme descrito no nosso [guia de tagging][tagging-guide]. Essas tags possibilitam
gerar URLs para sua própria aplicação, criando deep links para páginas no seu próprio
sistema, como perfis de usuário relacionados ou posts de blog.

## Taggeando requisições

Para que os link templates funcionem, o AppSignal precisa ter os dados necessários para criar
os links. Comece adicionando tags às requisições na sua aplicação.

Adicione o código a seguir em um local onde ele seja executado para a requisição
relacionada, como um bloco `before_action` em uma aplicação Ruby on Rails ou
usando Plug no framework Elixir Phoenix.

<CodeGroup>
  ```ruby Ruby theme={null}
  # Ruby example
  AppSignal.tag_request(
    :user_id    => current_user.id,
    :account_id => current_account.id
  )
  ```

  ```elixir Elixir theme={null}
  # Elixir example
  AppSignal.Span.set_sample_data(
    Appsignal.Tracer.root_span,
    "tags",
    %{
      locale: "en",
      user_id: user_id,
      stripe_customer_id: stripe_customer_id,
      locale: locale,
      default_locale: default_locale
    }
  )
  ```
</CodeGroup>

<Note>
  📖 Para mais informações sobre como taggear requisições, leia o [guia de
  tagging][tagging-guide].
</Note>

## Atributos de log

O AppSignal também pode gerar links com base em atributos de log.

Para mais informações sobre logging e como adicionar atributos de log, veja nossa [documentação de logging](/logging)

## Criando um link template

Os link templates podem ser definidos em AppSignal.com por aplicação.

A configuração de "Link templates" pode ser encontrada na [seção "App settings"](https://appsignal.com/redirect-to/app?to=edit) na navegação do lado esquerdo.

<img src="https://mintcdn.com/appsignal-715f5a51/nF8c1Rwq1cS7b5hg/assets/images/screenshots/application/link_templates/link-templates.png?fit=max&auto=format&n=nF8c1Rwq1cS7b5hg&q=85&s=41a6b8f078d4995d0b99c076c6959a07" alt="link templates" width="2560" height="1120" data-path="assets/images/screenshots/application/link_templates/link-templates.png" />

Os link templates podem conter variáveis, definidas envolvendo-as em sinais de porcentagem
`%%`. Por exemplo, a tag `user_id` pode ser usada em um link assim:

```shell Shell theme={null}
https://yourapp.com/backend/users/%user_id%
```

Um link pode conter quantas variáveis você quiser, mas para que um link seja
gerado, todas as variáveis precisam estar presentes nas tags de uma requisição.

Após adicionar tags no seu app e definir os link templates, os links serão
gerados para cada requisição na seção "Overview".

<img src="https://mintcdn.com/appsignal-715f5a51/nF8c1Rwq1cS7b5hg/assets/images/screenshots/application/link_templates/link-templates-result.png?fit=max&auto=format&n=nF8c1Rwq1cS7b5hg&q=85&s=0bf6e6c15c99b1c4b132e1d151e5d3f9" alt="link templates" width="2560" height="1836" data-path="assets/images/screenshots/application/link_templates/link-templates-result.png" />

### Personalizando os nomes dos links

Por padrão, a tabela de tags e links incrementa os nomes dos links, por exemplo, "Link 1", "Link 2", "Link 3". Se quiser usar nomes mais descritivos, você pode fazer isso com este formato:

```shell Shell theme={null}
[Backend]https://yourapp.com/backend/users/%user_id%
```

[tagging-guide]: /guides/tagging.html
