Usar a Pesquisa no Application InsightsUsing Search in Application Insights

A Pesquisa é um recurso do Application Insights que você usa para localizar e explorar itens individuais de telemetria, como exibições de página, exceções ou solicitações da Web.Search is a feature of Application Insights that you use to find and explore individual telemetry items, such as page views, exceptions, or web requests. Você também pode exibir rastreamentos de log e eventos que você tenha codificado.And you can view log traces and events that you have coded.

(Para consultas mais complexas sobre os dados, use o Analytics.)(For more complex queries over your data, use Analytics.)

No portal do AzureIn the Azure portal

Você pode abrir a pesquisa de diagnóstico na guia Visão geral Application Insights do seu aplicativo (localizada na barra superior) ou em investigar à esquerda.You can open diagnostic search from the Application Insights Overview tab of your application (located at in the top bar) or under investigate on the left.

Guia Pesquisar

Vá para o menu suspenso tipos de evento para ver uma lista de itens de telemetria-solicitações de servidor, exibições de página, eventos personalizados que você tenha codificado e assim por diante.Go to the Event types' drop-down menu to see a list of telemetry items- server requests, page views, custom events that you have coded, and so on. Na parte superior da lista de resultados, é um gráfico de resumo mostrando contagens de eventos ao longo do tempo.At the top of the results' list, is a summary chart showing counts of events over time.

Clique no menu suspenso ou em atualizar para obter novos eventos.Click out of the drop-down menu or Refresh to get new events.

No Visual StudioIn Visual Studio

No Visual Studio, há também uma janela da Pesquisa do Application Insights.In Visual Studio, there's also an Application Insights Search window. É mais útil exibir eventos de telemetria gerados pelo aplicativo que você está depurando.It's most useful for displaying telemetry events generated by the application that you're debugging. Contudo, ele também pode mostrar os eventos coletados do seu aplicativo publicado no Portal do Azure.But it can also show the events collected from your published app at the Azure portal.

Abra a janela Pesquisar no Visual Studio:Open the Search window in Visual Studio:

O Visual Studio abre a pesquisa do Application Insights

A janela Pesquisar tem os mesmos recursos que o portal da Web:The Search window has features similar to the web portal:

Janela de pesquisa do Visual Studio Application Insights

A guia Controlar Operação está disponível ao abrir uma solicitação ou uma exibição de página.The Track Operation tab is available when you open a request or a page view. Uma “operação” é uma sequência de eventos associada a uma única solicitação ou exibição de página.An 'operation' is a sequence of events that is associated with to a single request or page view. Por exemplo, chamadas de dependência, exceções, logs de rastreamento e eventos personalizados podem fazer parte de uma única operação.For example, dependency calls, exceptions, trace logs, and custom events might be part of a single operation. A guia Controlar Operação mostra graficamente o tempo e a duração desses eventos em relação à exibição de solicitação ou página.The Track Operation tab shows graphically the timing and duration of these events in relation to the request or page view.

Inspecionar itens individuaisInspect individual items

Selecione qualquer item de telemetria para ver os campos-chave e itens relacionados.Select any telemetry item to see key fields and related items.

Captura de tela de uma solicitação de dependência individual

Isso iniciará a exibição de detalhes da transação completa.This will launch the end-to-end transaction details view.

Filtrar tipos de eventoFilter event types

Abra o menu suspenso tipos de eventos e escolha os tipos de eventos que você deseja ver.Open the Event types' drop-down menu and choose the event types you want to see. (Se, posteriormente, você quiser restaurar os filtros, clique em Redefinir.)(If, later, you want to restore the filters, click Reset.)

Os tipos de evento são:The event types are:

Filtrar pelos valores de propriedadeFilter on property values

Você pode filtrar eventos pelos valores de suas propriedades.You can filter events on the values of their properties. As propriedades disponíveis dependem dos tipos de evento que você selecionou.The available properties depend on the event types you selected. Clique no ícone de filtroClick on the filter icon Ícone de filtro para iniciar.to start.

Não escolher nenhum valor para uma determinada propriedade tem o mesmo efeito que escolher todos os valores.Choosing no values of a particular property has the same effect as choosing all values. Ele desativará a filtragem nessa propriedade.It switches off filtering on that property.

Observe que as contagens à direita dos valores de filtro mostram quantas ocorrências existem no atual conjunto filtrado.Notice that the counts to the right of the filter values show how many occurrences there are in the current filtered set.

Encontrar eventos com a mesma propriedadeFind events with the same property

Para localizar todos os itens com o mesmo valor de propriedade, digite-os na barra de pesquisa ou clique na caixa de seleção ao examinar propriedades na guia filtro.To find all the items with the same property value, either type it into the search bar or click the checkbox when looking through properties in the filter tab.

Clique na caixa de seleção de uma propriedade na guia filtro

Pesquisar os dadosSearch the data

Observação

Para gravar consultas mais complexas, abra logs (análise) na parte superior da folha de pesquisa.To write more complex queries, open Logs (Analytics) from the top of the Search blade.

Você pode pesquisar termos em qualquer um dos valores de propriedade.You can search for terms in any of the property values. Isso será útil se você tiver escrito eventos personalizados com valores de propriedade.This is useful if you have written custom events with property values.

Você talvez queira definir um tempo de intervalo, já que pesquisas em um intervalo mais curto são mais rápidas.You might want to set a time range, as searches over a shorter range are faster.

Abra a pesquisa de diagnóstico

Pesquisar por palavras inteiras, não subcadeias de caracteres.Search for complete words, not substrings. Use aspas para delimitar caracteres especiais.Use quotation marks to enclose special characters.

CadeiaString Não encontradoNot found EncontradoFound
ControladorInicial.SobreHomeController.About home
controller
out
homecontroller
about
"homecontroller.about"
Estados UnidosUnited States Uni
ted
united
states
united AND states
"united states"

Estas são algumas expressões de pesquisa que você pode usar:Here are the search expressions you can use:

Exemplo de consultaSample query EfeitoEffect
apple Encontrar todos os eventos no período cujos campos incluem a palavra “maçã”Find all events in the time range whose fields include the word "apple"
apple AND banana
apple banana
Encontrar eventos que contêm as duas palavras.Find events that contain both words. Use "AND” em letras maiúsculas, e não "and".Use capital "AND", not "and".
Forma abreviada.Short form.
apple OR banana Encontrar eventos que contêm uma das duas palavras.Find events that contain either word. Use "OR", e não "or".Use "OR", not "or".
apple NOT banana Encontre eventos que contêm uma das palavras, mas não a outra.Find events that contain one word but not the other.

amostragemSampling

Se seu aplicativo gerar uma grande quantidade de telemetria (e você estiver usando o ASP.NET SDK versão 2.0.0-Beta3 ou posterior), o módulo de amostragem adaptável reduzirá automaticamente o volume que é enviado ao portal enviando apenas uma fração representativa de eventos.If your app generates a large amount of telemetry (and you are using the ASP.NET SDK version 2.0.0-beta3 or later), the adaptive sampling module automatically reduces the volume that is sent to the portal by sending only a representative fraction of events. No entanto, os eventos relacionados à mesma solicitação serão selecionadas ou desmarcadas como um grupo, para que você possa navegar entre os eventos relacionados.However, events that are related to the same request are selected or deselected as a group, so that you can navigate between related events.

Saiba mais sobre amostragem.Learn about sampling.

Criar item de trabalhoCreate work item

Você pode criar um bug no GitHub ou Azure DevOps com os detalhes de qualquer item de telemetria.You can create a bug in GitHub or Azure DevOps with the details from any telemetry item.

Vá para a exibição de detalhes da transação de ponta a ponta clicando em qualquer item de telemetria e, em seguida, selecione Criar item de trabalho.Go to the end-to-end transaction detail view by clicking on any telemetry item then select Create work item.

Clique em Novo Item de Trabalho, edite os campos e, em seguida, clique em OK.

Na primeira vez que fizer isso, será solicitado que você configure um link para sua conta e projeto do Azure DevOps.The first time you do this, you are asked to configure a link to your Azure DevOps organization and project.

(Você também pode configurar o link na guia itens de trabalho.)(You can also configure the link on the Work Items tab.)

Enviar mais telemetria para o Application InsightsSend more telemetry to Application Insights

Além de telemetria da caixa enviada pelo SDK do Application Insights, você pode:In addition to the out-of-the-box telemetry sent by Application Insights SDK, you can:

  • Capturar rastreamentos de log da sua estrutura de registros favorita no .NET ou Java.Capture log traces from your favorite logging framework in .NET or Java. Isso significa que você pode pesquisar os rastreamentos de log e correlacioná-los com outros eventos, exceções e visualizações de página.This means you can search through your log traces and correlate them with page views, exceptions, and other events.
  • Escrever código para enviar eventos personalizados, visualizações de página e exceções.Write code to send custom events, page views, and exceptions.

Saiba como enviar logs e telemetria personalizada para o Application Insights.Learn how to send logs and custom telemetry to Application Insights.

Perguntas e respostasQ & A

Que quantidade de dados é mantida?How much data is retained?

Veja o Resumo de limites.See the Limits summary.

Como consultar dados de POSTAGEM nas minhas solicitações de servidor?How can I see POST data in my server requests?

Nós não registramos os dados de POST automaticamente, mas você pode usar chamadas de log ou TrackTrace.We don't log the POST data automatically, but you can use TrackTrace or log calls. Coloque os dados de POSTAGEM no parâmetro de mensagem.Put the POST data in the message parameter. Não é possível filtrar a mensagem da mesma maneira que as propriedades, mas o limite de tamanho é maior.You can't filter on the message in the same way you can filter on properties, but the size limit is longer.

Próximas etapasNext steps