> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8a08bda2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Pesquisa no ClickStack

> Pesquisa no ClickStack

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

O ClickStack permite fazer pesquisa de texto completo nos seus eventos (logs e traces). Você pode começar a pesquisar apenas digitando palavras-chave que correspondam aos seus eventos. Por exemplo, se o seu log contiver "Error", você poderá encontrá-lo apenas digitando "Error" na barra de pesquisa.

Essa mesma sintaxe de busca também é usada para filtrar eventos em dashboards e gráficos.

<div id="search-features">
  ## Funcionalidades de busca
</div>

<div id="natural-language-syntax">
  ### Sintaxe de busca em linguagem natural
</div>

* As buscas não diferenciam maiúsculas de minúsculas
* Por padrão, as buscas correspondem a palavras inteiras (ex.: `Error` corresponderá a `Error here`
  mas não a `Errors here`). Você pode cercar uma palavra com curingas para corresponder a
  palavras parciais (ex.: `*Error*` corresponderá a `AnyError` e `AnyErrors`)
* Os termos de busca são pesquisados em qualquer ordem (ex.: `Hello World` corresponderá a logs que
  contenham `Hello World` e `World Hello`)
* Você pode excluir palavras-chave usando `NOT` ou `-` (ex.: `Error NOT Exception` ou
  `Error -Exception`)
* Você pode usar `AND` e `OR` para combinar várias palavras-chave (ex.:
  `Error OR Exception`)
* Correspondências exatas podem ser feitas com aspas duplas (ex.: `"Error tests not found"`)

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8a08bda2/16jdCy1HTWZ9Bvmz/images/use-cases/observability/hyperdx-27.png?fit=max&auto=format&n=16jdCy1HTWZ9Bvmz&q=85&s=2d311a1e0ba7da3080e90cfb1021692a" alt="Pesquisa" size="md" width="3430" height="2340" data-path="images/use-cases/observability/hyperdx-27.png" />

<div id="column-search">
  #### Pesquisa por coluna/propriedade
</div>

* Você pode pesquisar colunas e propriedades em JSON/map usando `column:value` (ex. `level:Error`,
  `service:app`)
* Você pode pesquisar uma faixa de valores usando operadores de comparação (`>`, `<`,
  `>=`, `<=`) (ex. `Duration:>1000`)
* Você pode pesquisar a existência de uma propriedade usando `property:*` (ex.
  `duration:*`)

<div id="time-input">
  ### Campo de tempo
</div>

* O campo de tempo aceita entradas em linguagem natural (ex.: `1 hour ago`, `yesterday`,
  `last week`)
* Especificar um único ponto no tempo fará com que a pesquisa seja realizada desse momento
  até agora.
* Ao pesquisar, o intervalo de tempo sempre será convertido para o intervalo interpretado para
  facilitar a depuração de consultas de tempo.
* Você também pode selecionar uma barra do histograma para ampliar um intervalo de tempo específico.

<div id="sql-syntax">
  ### Sintaxe de busca SQL
</div>

Opcionalmente, você pode alternar os campos de busca para o modo SQL. Nesse modo, eles aceitam qualquer
cláusula WHERE SQL válida para pesquisa. Isso é útil para consultas complexas que não podem ser
expressas na sintaxe do Lucene.

<div id="select-statement">
  ### Instrução SELECT
</div>

Para especificar as colunas a serem exibidas nos resultados da pesquisa, você pode usar o campo `SELECT`.
Trata-se de uma expressão SQL SELECT para definir as colunas a serem selecionadas na página de pesquisa.
Aliases ainda não são compatíveis no momento (ex.: você não pode usar `column as "alias"`).

<div id="saved-searches">
  ## Pesquisas salvas
</div>

Você pode salvar suas pesquisas para acessá-las rapidamente depois. Depois de salvas, elas aparecerão na página `Saved Searches`, facilitando revisitar pesquisas usadas com frequência sem precisar recriá-las.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8a08bda2/vnVcNA3Hildxme_Z/images/use-cases/observability/clickstack-saved-search-listing.png?fit=max&auto=format&n=vnVcNA3Hildxme_Z&q=85&s=04d07350f6fb6818b7a09f9ad506f2ec" alt="Página de listagem de pesquisas salvas" size="lg" width="1468" height="614" data-path="images/use-cases/observability/clickstack-saved-search-listing.png" />

Para salvar uma pesquisa, basta configurar sua pesquisa e clicar no botão de salvar. Você pode dar à pesquisa salva um nome descritivo para ajudar a identificá-la depois.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8a08bda2/vnVcNA3Hildxme_Z/images/use-cases/observability/clickstack-saved-search.png?fit=max&auto=format&n=vnVcNA3Hildxme_Z&q=85&s=0fb135768b2d9758cbe233ea98f7a9d2" alt="Salvando uma pesquisa" size="md" width="912" height="711" data-path="images/use-cases/observability/clickstack-saved-search.png" />

<div id="alerts-on-saved-searches">
  ### Adicionando alertas a pesquisas salvas
</div>

Pesquisas salvas podem ser monitoradas com alertas para notificar você quando determinadas condições forem atendidas. Você pode configurar alertas para serem disparados quando o número de eventos que correspondem à sua pesquisa salva exceder ou ficar abaixo de um limite especificado.

Para mais informações sobre como criar e configurar alertas, consulte a [documentação de alertas](/pt-BR/clickstack/features/alerts).

<div id="tagging">
  ### Marcação com tags
</div>

Você pode adicionar tags a dashboards e pesquisas salvas para ajudar a organizá-los.
As tags oferecem uma forma flexível de categorizar e filtrar de acordo com as suas necessidades.

<div id="how-tags-work">
  #### Como as tags funcionam
</div>

* **Organização**: As tags aparecem na barra lateral esquerda, onde dashboards e pesquisas salvas são agrupados de acordo com as tags atribuídas
* **Múltiplas tags**: Você pode adicionar uma ou mais tags a um único item para melhorar a categorização
* **Criação automática**: Se você atribuir uma tag que ainda não existe, ela será criada automaticamente
* **Gerenciamento simples**: Você pode adicionar ou remover tags a qualquer momento para ajustar sua estrutura de organização

Isso facilita encontrar itens relacionados e manter um workspace organizado à medida que sua coleção cresce.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8a08bda2/vnVcNA3Hildxme_Z/images/use-cases/observability/clickstack-tags-search.png?fit=max&auto=format&n=vnVcNA3Hildxme_Z&q=85&s=61ffc809253e67f908264fcf2b75f207" alt="Tags na pesquisa salva" size="md" border width="743" height="230" data-path="images/use-cases/observability/clickstack-tags-search.png" />

Você também pode selecionar várias tags para filtrar e visualizar itens de diferentes categorias:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8a08bda2/vnVcNA3Hildxme_Z/images/use-cases/observability/clickstack-tags-dashboard.png?fit=max&auto=format&n=vnVcNA3Hildxme_Z&q=85&s=cbb372afa375d0041857743d95430571" alt="Várias tags selecionadas no dashboard" size="md" border width="529" height="252" data-path="images/use-cases/observability/clickstack-tags-dashboard.png" />