Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Neste documento, descrevemos como analisar o histórico de execução dos seus
monitores sintéticos e como acessar as métricas e os
registros coletados.
Esse recurso só é compatível com projetos Google Cloud .
Para configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta com app ativado.
Antes de começar
Conclua as seguintes etapas no projeto do Google Cloud que armazena seu monitor sintético:
Para receber as permissões necessárias para ver os resultados da execução de monitores sintéticos usando o console Google Cloud ,
peça ao administrador para conceder a você os
seguintes papéis do IAM no projeto:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.
Na barra de ferramentas do console Google Cloud ,
selecione seu projeto Google Cloud . Para configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta com app ativado.
Para abrir a página Detalhes do monitor sintético, localize o
monitor sintético que você quer visualizar e clique no nome dele.
A página Detalhes do monitor sintético lista informações resumidas, como
a taxa de sucesso e a duração, além do status mais recente. Essa página também mostra a duração registrada da execução e contém uma tabela com uma linha para cada execução.
Cada linha da tabela lista o status, a data, a duração e um link para uma página que mostra o código atual e os registros relevantes para essa execução.
Ver registros e rastreamentos de uma execução
Para conferir os registros, rastreamentos e informações de resumo de uma execução,
na página Detalhes do monitor sintético, clique no link da execução.
Nessa página, é possível fazer o seguinte:
Para testes do Mocha, confira os resultados de cada teste. Por exemplo, se o monitor sintético tiver quatro testes do Mocha, o painel Resultados do teste vai ter quatro entradas.
Cada entrada na lista é anotada como aprovada ou reprovada.
Se você selecionar uma entrada marcada como falha, o código com falha será exibido
e destacado.
Ver dados de registro
Os registros são coletados automaticamente pelo Cloud Monitoring. Eles contêm informações sobre o teste e detalhes da falha. Os registros disponíveis dependem da sua função do Cloud Run. Por exemplo, se você usar o
Mocha, os
registros vão incluir informações sobre se o teste foi aprovado ou reprovado, a duração
do teste e, em caso de falha, um stack trace completo. O
stack trace inclui a linha de código que falhou, os tipos de erro e
as mensagens de erro.
Para conferir os detalhes dos registros relacionados, no painel Registros de execução,
expanda uma entrada de registro.
A entrada de registro é mostrada no formato JSON. Se você preferir ver os
registros com o Explorador de registros, clique em Abrir no Explorador de registros.
A Análise de registros é aberta, e uma consulta é pré-configurada.
Visualizar dados de trace
Os dados de rastreamento são coletados quando sua função do Cloud Run
é executada. Para conferir os dados de rastreamento, use o console Google Cloud ou a API Cloud Trace.
Console
Para visualizar os dados de trace, faça o seguinte:
Para ver um resumo das informações de um trace, na barra de ferramentas da página de detalhes de uma execução, clique em Ver detalhes do trace.
O painel Detalhes é aberto e mostra um diagrama de Gantt com informações sobre cada período, que é um registro de uma operação no trace. Para
informações completas sobre o trace e os períodos dele, clique em
Ver no Cloud Trace, que abre a página do Explorador de traces.
Confira seus traces no Cloud Trace:
No console Google Cloud , acesse a página Explorador de traces:
Também é possível encontrar essa página usando a barra de pesquisa.
Na barra de ferramentas do console Google Cloud ,
selecione seu projeto Google Cloud . Para configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta com app ativado.
No gráfico de mapa de calor ou na tabela, selecione um trace.
Seu rastreamento e intervalos podem incluir círculos na linha do tempo que representam entradas de registro ou eventos que ocorreram durante a execução. Clique no círculo para mostrar informações sobre a entrada de registro ou o evento. Para identificar uma função do Cloud Run em uma entrada de registro, consulte o campo resource.labels.service_name.
Recomendamos usar o console Google Cloud para ver os dados de rastreamento.
No entanto, se você quiser usar a API Cloud Trace, use o método traces.list para listar os traces disponíveis e o método traces.get para receber os detalhes de um trace.
Ver registros e métricas de uma função do Cloud Run
Os registros e as métricas fornecem informações sobre as ações que sua
função do Cloud Run está realizando. Por exemplo, registros que contêm um campo chamado userAgent com um valor de GoogleStackdriverMonitoring-UptimeChecks indicam que seu serviço recebeu uma solicitação do serviço de verificação de tempo de atividade.
O restante desta seção descreve como visualizar os registros e as métricas
coletados pelas funções do Cloud Run.
Ver registros da função
Console
Para conferir os registros de funções do Cloud Run, faça o seguinte:
No painel com o nome do seu monitor sintético, clique no nome da função do Cloud Run.
Na página Detalhes da função, selecione a guia Registros.
Para monitores sintéticos, as métricas são coletadas pelo Cloud Monitoring e pelas funções do Cloud Run:
O Cloud Monitoring coleta métricas sobre cada execução de um
monitor sintético. Essas métricas incluem a latência da execução do código e o histórico de sucesso. Para informações sobre como visualizar essas métricas, consulte
Ver o histórico de execução de um monitor sintético.
O Cloud Run functions coleta métricas sobre cada função do Cloud Run. Essas métricas registram o tempo de execução, a utilização de memória, a contagem de instâncias e o número de invocações por seção. O restante desta seção descreve como visualizar essas métricas.
Console
Para conferir as métricas da função do Cloud Run, faça o seguinte:
No painel com o nome do seu monitor sintético, clique no nome da função do Cloud Run.
Na página Detalhes da função, selecione a guia Métricas.
Para ampliar um intervalo de tempo específico, faça o seguinte:
Em um gráfico, posicione o ponteiro em uma extremidade do período e clique com o botão esquerdo.
Arraste o ponteiro horizontalmente para a outra extremidade do intervalo de tempo e solte o botão.
Para analisar os dados mostrados em um gráfico com mais detalhes,
na barra de ferramentas do gráfico, selecione more_vertMais opções de gráfico
e faça uma seleção. As opções incluem:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-28 UTC."],[],[],null,["# Explore synthetic monitor results\n\nThis document describes how you explore the execution history of your\nsynthetic monitors, and it also describes how to view the collected metrics and\nlogs.\n\nThis feature is supported only for Google Cloud projects.\nFor [App Hub](/app-hub/docs/overview)\nconfigurations, select the App Hub host project or\nthe app-enabled folder's management project.\n\nBefore you begin\n----------------\n\nComplete the following in the Google Cloud project that stores your synthetic monitor:\n\n-\n\n To get the permissions that\n you need to view synthetic monitors execution results by using the Google Cloud console,\n\n ask your administrator to grant you the\n following IAM roles on your project:\n\n - [Monitoring Viewer](/iam/docs/roles-permissions/monitoring#monitoring.viewer) (`roles/monitoring.viewer`)\n - [Cloud Functions Developer](/iam/docs/roles-permissions/cloudfunctions#cloudfunctions.developer) (`roles/cloudfunctions.developer`)\n - [Logs Viewer](/iam/docs/roles-permissions/logging#logging.viewer) (`roles/logging.viewer`)\n\n\n For more information about granting roles, see [Manage access to projects, folders, and organizations](/iam/docs/granting-changing-revoking-access).\n\n\n You might also be able to get\n the required permissions through [custom\n roles](/iam/docs/creating-custom-roles) or other [predefined\n roles](/iam/docs/roles-overview#predefined).\n\nView execution history for a synthetic monitor\n----------------------------------------------\n\nTo understand the history of passing and failing executions, view the\n**Synthetic monitor details** page for the synthetic monitor:\n\n1. In the Google Cloud console, go to the\n **Synthetic monitoring** page:\n\n [Go to **Synthetic monitoring**](https://console.cloud.google.com/monitoring/synthetic-monitoring)\n\n \u003cbr /\u003e\n\n If you use the search bar to find this page, then select the result whose subheading is\n **Monitoring**.\n2. In the toolbar of the Google Cloud console, select your Google Cloud project. For [App Hub](/app-hub/docs/overview) configurations, select the App Hub host project or the app-enabled folder's management project.\n3. To open the **Synthetic monitor details** page, locate the synthetic monitor that you want to view, and then click its name.\n\nThe **Synthetic monitor details** page lists summary information, such as\nthe success rate and duration and the most recent status. This page also charts\nthe recorded duration of the execution and it contains a table that displays\none row for each execution.\n\nEach row in the table lists the status, date, duration, and it links to a\npage that displays the current code and logs relevant to that execution.\n\nView logs and traces for an execution\n-------------------------------------\n\nTo view the logs, traces, and summary information for an execution,\non the **Synthetic monitor details** page, click the link to the execution.\nFrom this page, you can do the following:\n\n- [View log data](#log-data).\n- [View trace data](#trace-data).\n- View the *current* code.\n\n | **Note:** Cloud Run functions stores one copy of your code. When you view the results for any execution, the displayed code is the *current* code and it might not be relevant to the specific execution.\n- Access the Cloud Run function.\n\n- For [Mocha](https://mochajs.org/) test, view results for each test. For example,\n if your synthetic monitor contains four Mocha tests,\n then the **Test results** pane contains four entries.\n Each entry in the list is annotated as a pass or fail.\n\n If you select an entry marked as failed, then the failing code is displayed\n and highlighted.\n\n### View log data\n\nLogs are automatically collected by Cloud Monitoring. These logs contain\ninformation about the test and failure details. The available logs depend on\nyour Cloud Run function. For example, if you use\n[Mocha](https://mochajs.org/), then the\nlogs include information about whether the test passed or failed, test\nduration, and, in the case of failure, a full stack trace. The\nstack trace includes the line of code that failed, error types, and\nerror messages.\n\nTo view details of your related logs, in the **Execution logs** pane,\nexpand a log entry.\n\nThe log entry is displayed in JSON format. If you prefer to view the\nlogs with the Logs Explorer, then click **Open in Logs Explorer**.\nThe Logs Explorer is opened and a query is preconfigured.\n\n### View trace data\n\nTrace data is collected when your Cloud Run function\nexecutes. To view trace data, use the Google Cloud console or the Cloud Trace API to\nview trace data. \n\n### Console\n\n\nTo view your trace data, do one of the following:\n\n- To view summary information for a trace, in the toolbar of the details page\n for an execution, click **View trace details**.\n\n The **Details** panel opens and displays a Gantt chart with information\n about each span, which is a record of an operation, in the trace. For\n complete information about the trace and its spans, click\n **View in Cloud Trace** , which opens the **Trace Explorer** page.\n- View your traces in Cloud Trace:\n\n 1. In the Google Cloud console, go to the **Trace explorer** page:\n\n [Go to **Trace explorer**](https://console.cloud.google.com/traces/explorer)\n\n \u003cbr /\u003e\n\n You can also find this page by using the search bar.\n 2. In the toolbar of the Google Cloud console, select your Google Cloud project. For [App Hub](/app-hub/docs/overview) configurations, select the App Hub host project or the app-enabled folder's management project.\n 3. In the heatmap chart or in the table, select a trace.\n\nYour trace and spans can include circles in the timeline that represent log\nentries or events that occurred during execution. Click the circle to\ndisplay information about the log entry or event. To identify a\nCloud Run function in a log entry, view the `resource.labels.service_name`\nfield.\n\nFor more information about exploring your trace data, see\n[Find and explore traces](/trace/docs/finding-traces).\n\n\u003cbr /\u003e\n\n### API\n\nWe recommend that you use the Google Cloud console to view trace data.\nHowever, if you want to use the Cloud Trace API, use the\n[`traces.list` method](/trace/docs/reference/v1/rest/v1/projects.traces/list) to list the available traces,\nand then use the\n[`traces.get` method](/trace/docs/reference/v1/rest/v1/projects.traces/get) to get the details of a trace.\n\nView logs and metrics for a Cloud Run function\n----------------------------------------------\n\nLogs and metrics provide you with information about the actions your\nCloud Run function is performing. For example, logs that contain a\nfield named `userAgent` with a value of\n`GoogleStackdriverMonitoring-UptimeChecks`, indicate that your service\nreceived a request from the uptime check service.\n\nThe remainder of this section describes how to view the logs and metrics\ncollected by Cloud Run functions.\n\n### View function logs\n\n### Console\n\n\nTo view Cloud Run function logs, do the following:\n\n1. In the pane with the name of your synthetic monitor, click the Cloud Run function name.\n2. On the **Function details** page, select the **Logs** tab.\n\nTo explore the log data in a chart in more detail, expand a log entry and then\nselect **Open in Logs Explorer** .\nFrom the [Logs Explorer](/logging/docs/view/logs-explorer-interface), you can\nperform actions such as refining the query, creating a\n[log-based metric](/logging/docs/logs-based-metrics), or\ncreate a [log-based alert](/logging/docs/alerting/log-based-alerts).\n\n\u003cbr /\u003e\n\n### API\n\nFor information about how to read and write Cloud Run function\nlogs programmatically, see\n[Writing, Viewing, and Responding to Logs](/functions/docs/monitoring/logging).\n\n### View function metrics\n\nFor synthetic monitors, metrics are collected by both Cloud Monitoring and\nCloud Run functions:\n\n- Cloud Monitoring collects metrics about each execution of a\n synthetic monitor. These metrics include the latency of the code execution and\n the success history. For information about how to view these metrics, see\n [View execution history for a synthetic monitor](#history).\n\n- Cloud Run functions collects metrics about each Cloud Run function. These\n metrics record the execution time, the memory utilization, the instance\n count, and the number of invocations per section. The remainder of\n this section describes how to view these metrics.\n\n### Console\n\n\nTo view Cloud Run function metrics, do the following:\n\n1. In the pane with the name of your synthetic monitor, click the Cloud Run function name.\n2. On the **Function details** page, select the **Metrics** tab.\n\nTo zoom into a specific time range, do the following:\n\n1. On a chart, place your pointer at one end of the time range and then left-click your pointer.\n2. Drag your pointer horizontally to the other end of the time range, and then release the pointer button.\n\nTo explore the displayed data in a chart in more detail,\non the chart toolbar, select *more_vert* **More chart options**,\nand then make a selection. The options include the following:\n\n- Download the chart as a PNG or CSV\n- Save the chart to a custom dashboard\n- Open Metrics Explorer\n- Expand or collapse the chart legend\n- Reset the zoom\n\n\u003cbr /\u003e"]]
Monitoramento sintético: