MCP Tools Reference: monitoring.googleapis.com

Ferramenta: list_dashboards

Use essa ferramenta como principal para recuperar uma lista de painéis de monitoramento personalizados em um projeto na nuvem do Google Cloud. Com os painéis de monitoramento personalizados, os usuários podem ver e analisar dados de diferentes fontes no mesmo contexto. Isso é útil para entender quais painéis personalizados estão configurados e disponíveis em um determinado projeto.

O exemplo de código a seguir mostra como usar curl para chamar a ferramenta MCP list_dashboards.

Solicitação curl
curl --location 'https://monitoring.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_dashboards",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Esquema de entrada

A solicitação ListDashboards.

ListDashboardsRequest

Representação JSON
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string
}
Campos
parent

string

Obrigatório. O escopo dos painéis a serem listados. O formato é:

projects/[PROJECT_ID_OR_NUMBER]
pageSize

integer

Um número positivo que é o número máximo de resultados a serem retornados. Se não for especificado, o padrão 1.000 será usado.

pageToken

string

Opcional. Se esse campo não estiver vazio, ele precisará conter o valor nextPageToken retornado por uma chamada anterior a esse método. O uso desse campo faz com que o método retorne outros resultados da chamada de método anterior.

Esquema de saída

A solicitação ListDashboards.

ListDashboardsResponse

Representação JSON
{
  "dashboards": [
    {
      object (Dashboard)
    }
  ],
  "nextPageToken": string
}
Campos
dashboards[]

object (Dashboard)

A lista de painéis solicitados.

nextPageToken

string

Se houver mais resultados do que os retornados, esse campo será definido como um valor não vazio. Para ver os outros resultados, use esse valor como page_token na próxima chamada para esse método.

Painel

Representação JSON
{
  "name": string,
  "displayName": string,
  "etag": string,
  "dashboardFilters": [
    {
      object (DashboardFilter)
    }
  ],
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    object (DashboardAnnotations)
  },

  // Union field layout can be only one of the following:
  "gridLayout": {
    object (GridLayout)
  },
  "mosaicLayout": {
    object (MosaicLayout)
  },
  "rowLayout": {
    object (RowLayout)
  },
  "columnLayout": {
    object (ColumnLayout)
  }
  // End of list of possible types for union field layout.
}
Campos
name

string

Identificador. O nome do recurso do painel.

displayName

string

Obrigatório. O nome mutável e legível.

etag

string

etag é usado para otimização do controle de simultaneidade, para ajudar a evitar que atualizações simultâneas de uma política substituam-se mutuamente. Uma etag é retornada na resposta a GetDashboard, e os usuários precisam colocar essa ETag na solicitação para UpdateDashboard para garantir que a mudança seja aplicada à mesma versão da configuração do painel. O campo não deve ser transmitido durante a criação do painel.

dashboardFilters[]

object (DashboardFilter)

Filtros para reduzir a quantidade de dados representados com base nos critérios de filtragem.

labels

map (key: string, value: string)

Rótulos aplicados ao painel

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

annotations

object (DashboardAnnotations)

Configuração para que as anotações de eventos apareçam neste painel.

Campo de união layout. Um elemento de contêiner raiz do painel que define o estilo de layout. layout pode ser apenas de um dos tipos a seguir:
gridLayout

object (GridLayout)

O conteúdo é organizado com um layout básico que reajusta uma lista simples de elementos informativos, como widgets ou blocos.

mosaicLayout

object (MosaicLayout)

O conteúdo é organizado como uma grade de blocos, com cada widget de conteúdo ocupando um ou mais blocos da grade.

rowLayout

object (RowLayout)

O conteúdo é dividido em linhas igualmente espaçadas, e os widgets são organizados na horizontal.

columnLayout

object (ColumnLayout)

O conteúdo é dividido em colunas com espaçamento igual, e os widgets são organizados verticalmente.

GridLayout

Representação JSON
{
  "columns": string,
  "widgets": [
    {
      object (Widget)
    }
  ]
}
Campos
columns

string (int64 format)

O número de colunas em que a largura da visualização é dividida. Se omitido ou definido como zero, um padrão do sistema será usado durante a renderização.

widgets[]

object (Widget)

Os elementos informativos organizados na linha de colunas primeiro.

Widget

Representação JSON
{
  "title": string,
  "id": string,
  "visibilityCondition": {
    object (VisibilityCondition)
  },
  "timeRange": {
    object (TimeRange)
  },

  // Union field content can be only one of the following:
  "xyChart": {
    object (XyChart)
  },
  "scorecard": {
    object (Scorecard)
  },
  "text": {
    object (Text)
  },
  "blank": {
    object
  },
  "alertChart": {
    object (AlertChart)
  },
  "timeSeriesTable": {
    object (TimeSeriesTable)
  },
  "collapsibleGroup": {
    object (CollapsibleGroup)
  },
  "logsPanel": {
    object (LogsPanel)
  },
  "incidentList": {
    object (IncidentList)
  },
  "pieChart": {
    object (PieChart)
  },
  "treemap": {
    object (Treemap)
  },
  "errorReportingPanel": {
    object (ErrorReportingPanel)
  },
  "sectionHeader": {
    object (SectionHeader)
  },
  "singleViewGroup": {
    object (SingleViewGroup)
  },
  "filterControl": {
    object (FilterControl)
  }
  // End of list of possible types for union field content.
}
Campos
title

string

Opcional. O título do widget.

id

string

Opcional. O ID do widget. Os IDs podem ser compostos por caracteres alfanuméricos, traços e sublinhados. Os IDs de widget são opcionais.

visibilityCondition

object (VisibilityCondition)

Opcional. Se definido, esse widget será renderizado apenas quando a condição for avaliada como verdadeira.

timeRange

object (TimeRange)

Opcional. Representa um período para o widget. Quando definido, esse período substitui o período do painel. Compatível apenas com widgets de linha, área empilhada e barra empilhada.

Campo de união content. O conteúdo define o componente usado para preencher o widget. content pode ser apenas de um dos tipos a seguir:
xyChart

object (XyChart)

Um gráfico de dados de série temporal.

scorecard

object (Scorecard)

Uma visão geral que resume dados de série temporal.

text

object (Text)

Uma string bruta ou markdown que mostra conteúdo textual.

blank

object

Um espaço em branco.

alertChart

object (AlertChart)

Um gráfico de dados da política de alertas.

timeSeriesTable

object (TimeSeriesTable)

Um widget que mostra dados de série temporal em formato tabular.

collapsibleGroup

object (CollapsibleGroup)

Um widget que agrupa os outros widgets. Todos os widgets dentro da área abrangida pelo widget de agrupamento são considerados widgets membros.

logsPanel

object (LogsPanel)

Um widget que mostra um fluxo de registros.

incidentList

object (IncidentList)

Um widget que mostra uma lista de incidentes.

pieChart

object (PieChart)

Um widget que mostra dados de série temporal como um gráfico de pizza.

treemap

object (Treemap)

Um widget que mostra dados como um mapa de árvore.

errorReportingPanel

object (ErrorReportingPanel)

Um widget que mostra uma lista de grupos de erros.

sectionHeader

object (SectionHeader)

Um widget que define um cabeçalho de seção para facilitar a navegação no painel.

singleViewGroup

object (SingleViewGroup)

Um widget que agrupa os outros widgets usando um menu suspenso.

filterControl

object (FilterControl)

Um widget que mostra um campo de entrada para mudar o valor de uma variável de modelo.

XyChart

Representação JSON
{
  "dataSets": [
    {
      object (DataSet)
    }
  ],
  "timeshiftDuration": string,
  "thresholds": [
    {
      object (Threshold)
    }
  ],
  "xAxis": {
    object (Axis)
  },
  "yAxis": {
    object (Axis)
  },
  "y2Axis": {
    object (Axis)
  },
  "chartOptions": {
    object (ChartOptions)
  }
}
Campos
dataSets[]

object (DataSet)

Obrigatório. Os dados mostrados neste gráfico.

timeshiftDuration

string (Duration format)

A duração usada para mostrar um gráfico de comparação. Um gráfico de comparação mostra simultaneamente valores de dois períodos semelhantes (por exemplo, métricas semana a semana). A duração precisa ser positiva e só pode ser aplicada a gráficos com conjuntos de dados do tipo de representação LINE.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

thresholds[]

object (Threshold)

Linhas de limite desenhadas horizontalmente no gráfico.

xAxis

object (Axis)

As propriedades aplicadas ao eixo x.

yAxis

object (Axis)

As propriedades aplicadas ao eixo y.

y2Axis

object (Axis)

As propriedades aplicadas ao eixo y2.

chartOptions

object (ChartOptions)

Opções de exibição do gráfico.

DataSet

Representação JSON
{
  "timeSeriesQuery": {
    object (TimeSeriesQuery)
  },
  "plotType": enum (PlotType),
  "legendTemplate": string,
  "minAlignmentPeriod": string,
  "targetAxis": enum (TargetAxis),
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "measures": [
    {
      object (Measure)
    }
  ],
  "breakdowns": [
    {
      object (Breakdown)
    }
  ],
  "sort": [
    {
      object (ColumnSortingOptions)
    }
  ]
}
Campos
timeSeriesQuery

object (TimeSeriesQuery)

Obrigatório. Campos para consultar dados de série temporal da API de métricas do Stackdriver.

plotType

enum (PlotType)

Como esses dados devem ser representados no gráfico.

legendTemplate

string

Uma string de modelo para nomear TimeSeries no conjunto de dados resultante. Precisa ser uma string com interpolações no formato ${label_name}, que será resolvida como o valor do rótulo.

minAlignmentPeriod

string (Duration format)

Opcional. O limite inferior na frequência de pontos de dados para esse conjunto de dados, implementado especificando o período mínimo de alinhamento a ser usado em uma consulta de série temporal. Por exemplo, se os dados forem publicados a cada 10 minutos, o min_alignment_period deverá ser de pelo menos 10 minutos. Não faria sentido buscar e alinhar dados em intervalos de um minuto.

Para consultas em PromQL, esse campo é usado para definir o intervalo mínimo da consulta step, controlando a granularidade dos dados. Valores maiores podem melhorar a performance em intervalos de tempo longos. Consulte Noções básicas de consultas e Consultas de intervalo para mais detalhes sobre o step do PromQL.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

targetAxis

enum (TargetAxis)

Opcional. O eixo de destino a ser usado para representar a métrica.

dimensions[]

object (Dimension)

Opcional. Um conjunto de colunas de dimensão.

measures[]

object (Measure)

Opcional. Uma coleção de medidas.

breakdowns[]

object (Breakdown)

Opcional. A coleção de detalhamentos a serem aplicados ao conjunto de dados.

sort[]

object (ColumnSortingOptions)

Opcional. Uma coleção de opções de classificação que afeta a ordem dos dados e da legenda.

TimeSeriesQuery

Representação JSON
{
  "unitOverride": string,
  "outputFullDuration": boolean,

  // Union field source can be only one of the following:
  "timeSeriesFilter": {
    object (TimeSeriesFilter)
  },
  "timeSeriesFilterRatio": {
    object (TimeSeriesFilterRatio)
  },
  "timeSeriesQueryLanguage": string,
  "prometheusQuery": string,
  "opsAnalyticsQuery": {
    object (OpsAnalyticsQuery)
  },
  "traceQuery": {
    object (TraceQuery)
  }
  // End of list of possible types for union field source.
}
Campos
unitOverride

string

A unidade de dados contida nas série temporal buscadas. Se não estiver vazio, essa unidade vai substituir qualquer unidade que acompanhe os dados buscados. O formato é o mesmo do campo unit em MetricDescriptor.

outputFullDuration

boolean

Opcional. Se definido, o Cloud Monitoring vai tratar toda a duração da consulta como o período de alinhamento para que haja apenas um valor de saída.

*Observação: isso pode substituir o período de alinhamento configurado, exceto nos casos em que uma série de pontos de dados é esperada, como: - XyChart - Gráfico de faísca do scorecard

Campo de união source. Parâmetros necessários para extrair dados para o gráfico. source pode ser apenas de um dos tipos a seguir:
timeSeriesFilter

object (TimeSeriesFilter)

Filtre parâmetros para buscar série temporal.

timeSeriesFilterRatio

object (TimeSeriesFilterRatio)

Parâmetros para buscar uma proporção entre dois filtros de série temporal.

timeSeriesQueryLanguage

string

Uma consulta usada para buscar série temporal com MQL.

prometheusQuery

string

Uma consulta usada para buscar série temporal com PromQL.

opsAnalyticsQuery

object (OpsAnalyticsQuery)

Prévia: uma consulta usada para buscar uma série temporal, de categoria ou numérica com SQL. Este é um recurso de prévia e pode estar sujeito a mudanças antes do lançamento final.

traceQuery

object (TraceQuery)

Opcional. Prévia: consulte os traces. Este é um recurso de prévia e pode estar sujeito a mudanças antes do lançamento final.

TimeSeriesFilter

Representação JSON
{
  "filter": string,
  "aggregation": {
    object (Aggregation)
  },
  "secondaryAggregation": {
    object (Aggregation)
  },

  // Union field output_filter can be only one of the following:
  "pickTimeSeriesFilter": {
    object (PickTimeSeriesFilter)
  },
  "statisticalTimeSeriesFilter": {
    object (StatisticalTimeSeriesFilter)
  }
  // End of list of possible types for union field output_filter.
}
Campos
filter

string

Obrigatório. O filtro de monitoramento que identifica os tipos de métricas, recursos e projetos a serem consultados.

aggregation

object (Aggregation)

Por padrão, os dados brutos de série temporal são retornados. Use esse campo para combinar várias série temporal em diferentes visualizações dos dados.

secondaryAggregation

object (Aggregation)

Aplique uma segunda agregação depois que aggregation for aplicado.

Campo de união output_filter. Seleciona um filtro de série temporal opcional. output_filter pode ser apenas de um dos tipos a seguir:
pickTimeSeriesFilter

object (PickTimeSeriesFilter)

Filtro de série temporal baseado em classificação.

statisticalTimeSeriesFilter
(deprecated)

object (StatisticalTimeSeriesFilter)

Filtro de série temporal baseado em estatísticas. Observação: esse campo está descontinuado e é completamente ignorado pela API.

Agregação

Representação JSON
{
  "alignmentPeriod": string,
  "perSeriesAligner": enum (Aligner),
  "crossSeriesReducer": enum (Reducer),
  "groupByFields": [
    string
  ]
}
Campos
alignmentPeriod

string (Duration format)

O alignment_period especifica um intervalo de tempo, em segundos, usado para dividir os dados em todos os time series em blocos de tempo consistentes. Isso será feito antes que o alinhador por série possa ser aplicado aos dados.

O valor precisa ser de pelo menos 60 segundos. Se um alinhador por série diferente de ALIGN_NONE for especificado, esse campo será obrigatório ou um erro será retornado. Se nenhum alinhador por série for especificado ou se o alinhador ALIGN_NONE for especificado, esse campo será ignorado.

O valor máximo de alignment_period é de 2 anos ou 104 semanas.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

perSeriesAligner

enum (Aligner)

Um Aligner descreve como alinhar temporalmente os pontos de dados em uma única série temporal. Exceto ALIGN_NONE, todos os alinhamentos agrupam matematicamente todos os pontos de dados em um alignment_period, resultando em um único ponto de dados para cada alignment_period com carimbo de data/hora de término no final do período.

Nem todas as operações de alinhamento podem ser aplicadas a todas as série temporal. As opções válidas dependem do metric_kind e do value_type da série temporal original. O alinhamento pode mudar o metric_kind ou o value_type da série temporal.

Os dados de série temporal precisam ser alinhados para realizar a redução entre séries temporais. Se cross_series_reducer for especificado, per_series_aligner também precisará ser especificado e não poderá ser igual a ALIGN_NONE, e alignment_period também precisará ser especificado. Caso contrário, um erro será retornado.

crossSeriesReducer

enum (Reducer)

A operação de redução a ser usada para combinar série temporal em uma única série temporal, em que o valor de cada ponto de dados na série resultante é uma função de todos os valores já alinhados nas série temporal de entrada.

Nem todas as operações de redução podem ser aplicadas a todas as série temporal. As opções válidas dependem do metric_kind e do value_type da série temporal original. A redução pode gerar uma série temporal com um metric_kind ou value_type diferente da série temporal de entrada.

Os dados de série temporal precisam ser alinhados primeiro (consulte per_series_aligner) para realizar a redução entre séries temporais. Se cross_series_reducer for especificado, per_series_aligner também precisará ser especificado e não poderá ser ALIGN_NONE. Um alignment_period também precisa ser especificado. Caso contrário, um erro será retornado.

groupByFields[]

string

O conjunto de campos a serem preservados quando cross_series_reducer é especificado. Os group_by_fields determinam como as série temporal são particionadas em subconjuntos antes da aplicação da operação de agregação. Cada subconjunto contém série temporal com o mesmo valor para cada um dos campos de agrupamento. Cada série temporal individual é membro de exatamente um subconjunto. O cross_series_reducer é aplicado a cada subconjunto de série temporal. Não é possível reduzir em diferentes tipos de recursos. Portanto, esse campo contém implicitamente resource.type. Os campos não especificados em group_by_fields são agregados. Se group_by_fields não for especificado e todas as séries temporais tiverem o mesmo tipo de recurso, elas serão agregadas em uma única série temporal de saída. Se cross_series_reducer não estiver definido, esse campo será ignorado.

Duração

Representação JSON
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Segundos assinados do período. Precisa estar entre -315.576.000.000 e +315.576.000.000 (inclusive). Observação: esses limites são calculados com base em: 60 s/min * 60 min/h * 24 h/dia * 365,25 dias/ano * 10.000 anos

nanos

integer

Frações assinadas de um segundo com resolução de nanossegundos do período. Durações menores que um segundo são representadas com um campo seconds 0 e um campo nanos positivo ou negativo. Para durações de um segundo ou mais, um valor diferente de zero para o campo nanos precisa ter o mesmo sinal do campo seconds. Precisa estar entre -999.999.999 e +999.999.999 (inclusive).

PickTimeSeriesFilter

Representação JSON
{
  "rankingMethod": enum (Method),
  "numTimeSeries": integer,
  "direction": enum (Direction),
  "interval": {
    object (Interval)
  }
}
Campos
rankingMethod

enum (Method)

ranking_method é aplicado a cada série temporal de forma independente para produzir o valor que será usado para comparar a série temporal com outras.

numTimeSeries

integer

Quantas série temporal podem passar pelo filtro.

direction

enum (Direction)

Como usar o ranking para selecionar série temporal que passam pelo filtro.

interval

object (Interval)

Selecionar os N principais fluxos/série temporal nesse intervalo

Intervalo

Representação JSON
{
  "startTime": string,
  "endTime": string
}
Campos
startTime

string (Timestamp format)

Opcional. Início inclusivo do intervalo.

Se especificado, um carimbo de data/hora correspondente a esse intervalo precisará ser igual ou posterior ao início.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

endTime

string (Timestamp format)

Opcional. Fim exclusivo do intervalo.

Se especificado, um carimbo de data/hora correspondente a esse intervalo precisará ser anterior ao fim.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

Carimbo de data/hora

Representação JSON
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Representa os segundos do horário UTC desde a época Unix 1970-01-01T00:00:00Z. Precisa estar entre -62135596800 e 253402300799 (o que corresponde a 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z).

nanos

integer

Frações não negativas de um segundo com resolução de nanossegundos. Esse campo é a parte de nanossegundos da duração, não uma alternativa aos segundos. Os valores de segundos negativos com frações ainda precisam ter valores em nanossegundos não negativos que representam períodos posteriores. O valor precisa ser de 0 a 999.999.999 (inclusive).

StatisticalTimeSeriesFilter

Representação JSON
{
  "rankingMethod": enum (Method),
  "numTimeSeries": integer
}
Campos
rankingMethod

enum (Method)

rankingMethod é aplicado a um conjunto de séries temporais, e o valor produzido para cada série temporal individual é usado para comparar uma série temporal específica com outras. Esses são métodos que não podem ser aplicados fluxo a fluxo, mas exigem o contexto completo de uma solicitação para avaliar série temporal.

numTimeSeries

integer

Quantas série temporal serão geradas.

TimeSeriesFilterRatio

Representação JSON
{
  "numerator": {
    object (RatioPart)
  },
  "denominator": {
    object (RatioPart)
  },
  "secondaryAggregation": {
    object (Aggregation)
  },

  // Union field output_filter can be only one of the following:
  "pickTimeSeriesFilter": {
    object (PickTimeSeriesFilter)
  },
  "statisticalTimeSeriesFilter": {
    object (StatisticalTimeSeriesFilter)
  }
  // End of list of possible types for union field output_filter.
}
Campos
numerator

object (RatioPart)

O numerador da proporção.

denominator

object (RatioPart)

O denominador da proporção.

secondaryAggregation

object (Aggregation)

Aplique uma segunda agregação depois que a proporção for calculada.

Campo de união output_filter. Seleciona um filtro opcional que é aplicado à série temporal depois de calcular a proporção. output_filter pode ser apenas de um dos tipos a seguir:
pickTimeSeriesFilter

object (PickTimeSeriesFilter)

Filtro de série temporal baseado em classificação.

statisticalTimeSeriesFilter
(deprecated)

object (StatisticalTimeSeriesFilter)

Filtro de série temporal baseado em estatísticas. Observação: esse campo está descontinuado e é completamente ignorado pela API.

RatioPart

Representação JSON
{
  "filter": string,
  "aggregation": {
    object (Aggregation)
  }
}
Campos
filter

string

Obrigatório. O filtro de monitoramento que identifica os tipos de métricas, recursos e projetos a serem consultados.

aggregation

object (Aggregation)

Por padrão, os dados brutos de série temporal são retornados. Use esse campo para combinar várias série temporal em diferentes visualizações dos dados.

OpsAnalyticsQuery

Representação JSON
{
  "sql": string
}
Campos
sql

string

Uma consulta SQL para buscar dados de série temporal, de categoria ou numérica.

TraceQuery

Representação JSON
{
  "spanDataValue": enum (SpanDataValue),
  "spanFilters": {
    object (SpanFilters)
  },
  "resourceContainer": string
}
Campos
spanDataValue

enum (SpanDataValue)

O tipo de valor de dados de período a ser mostrado no gráfico. Obrigatório.

spanFilters

object (SpanFilters)

Primeira versão da filtragem de intervalos que vamos oferecer suporte. Obrigatório.

resourceContainer

string

Opcional. O nome do recurso do projeto ou do escopo de rastreamento para buscar dados. Se estiver vazio, o widget vai usar o escopo de rastreamento padrão do projeto. Se não for possível determinar o escopo, vamos usar o projeto atual. Opcional.

SpanFilters

Representação JSON
{
  "services": [
    string
  ],
  "displayNames": [
    string
  ],
  "status": [
    string
  ],
  "kinds": [
    string
  ],
  "minDuration": string,
  "maxDuration": string,
  "attributes": [
    {
      object (SpanAttributeFilter)
    }
  ],
  "isRootSpan": boolean,
  "applicationIds": [
    string
  ],
  "apphubServices": [
    string
  ],
  "apphubWorkloads": [
    string
  ]
}
Campos
services[]

string

Opcional. Filtrar intervalos que contêm um dos serviços na lista. Vários valores serão combinados com "OR".

displayNames[]

string

Opcional. Filtragem de períodos que contêm um dos nomes de exibição de período na lista. Vários valores serão combinados com "OR".

status[]

string

Opcional. Filtragem de intervalos que contêm um dos status na lista. Vários valores serão combinados com "OR".

kinds[]

string

Opcional. Filtragem de intervalos que contêm um dos tipos na lista. Vários valores serão combinados com "OR".

minDuration

string (Duration format)

Opcional. Filtrar intervalos com uma duração mínima.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

maxDuration

string (Duration format)

Opcional. Filtrar intervalos com uma duração máxima.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

attributes[]

object (SpanAttributeFilter)

Opcional. Lista de filtros de atributos de período. Cada chave SpanAttributeFilter precisa ser única. Vários filtros de atributos serão unidos por AND.

isRootSpan

boolean

Opcional. Filtra apenas os intervalos principais se definido como "true". Um período raiz é um intervalo sem um ID de período pai definido.

applicationIds[]

string

Opcional. Filtragem de intervalos que contêm um dos IDs de aplicativo do Apphub na lista. Vários valores serão combinados com "OR".

apphubServices[]

string

Opcional. Filtrar intervalos que contêm um dos IDs de serviço do Apphub na lista. Vários valores serão combinados com "OR". Exemplo: ["service-id1", "service-id2"]

apphubWorkloads[]

string

Opcional. Filtrando intervalos que contêm um dos IDs de carga de trabalho do Apphub na lista. Vários valores serão combinados com "OR". Exemplo: ["workload-id1", "workload-id2"]

SpanAttributeFilter

Representação JSON
{
  "key": string,
  "value": [
    string
  ]
}
Campos
key

string

Chave do atributo

value[]

string

Lista de valores de atributo para a chave especificada. Vários valores serão combinados com "OR".

Dimensão

Representação JSON
{
  "column": string,
  "columnType": string,
  "maxBinCount": integer,
  "sortOrder": enum (SortOrder),
  "sortColumn": string,
  "xMin": number,
  "xMax": number,

  // Union field bin_size can be only one of the following:
  "timeBinSize": string,
  "numericBinSize": integer,
  "floatBinSize": number
  // End of list of possible types for union field bin_size.
}
Campos
column

string

Obrigatório. Para widgets que usam consultas SQL, defina o valor como o nome da coluna na tabela de resultados cujos dados são representados em um gráfico. Para um histograma que usa uma consulta de série temporal, defina o valor desse campo como metric_value.

columnType

string

Opcional. O tipo da coluna de dimensão. Isso só é relevante se um dos campos "bin_size" estiver definido. Se estiver vazio, o tipo TIMESTAMP ou INT64 será presumido com base no campo bin_size definido. Se preenchido, ele precisa ser definido como um dos seguintes tipos: DATE, TIME, DATETIME, TIMESTAMP, BIGNUMERIC, INT64, NUMERIC, FLOAT64.

maxBinCount

integer

Para widgets que usam consultas SQL, o limite do número de agrupamentos a serem gerados. Quando 0 é especificado, a contagem máxima não é aplicada. Para um histograma que usa uma consulta de série temporal, o número exato de agrupamentos a serem gerados. Se não for especificado ou o valor for 0, o histograma vai determinar o número de agrupamentos a serem usados.

sortOrder

enum (SortOrder)

A ordem de classificação aplicada à coluna de classificação.

sortColumn

string

O nome da coluna para ordenar para agrupamento por classes. Essa coluna pode ser a mesma dimensão ou qualquer outra coluna usada como uma medida nos resultados. Se sort_order for definido como NONE, esse valor não será usado.

xMin

number

O valor mínimo para o eixo x.

xMax

number

O valor máximo do eixo x.

Campo de união bin_size. Os valores de bin_size são usados para configurar o agrupamento de pontos para a dimensão especificada pelo campo column. bin_size pode ser apenas de um dos tipos a seguir:
timeBinSize

string (Duration format)

time_bin_size é usado quando o tipo de dados da dimensão especificada é um tipo de tempo e o tamanho do agrupamento é determinado por uma duração. Se column_type for DATE, esse valor precisará ser um número inteiro múltiplo de um dia. Se column_type for TIME, esse valor precisará ser menor ou igual a 24 horas.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

numericBinSize

integer

numeric_bin_size é usado quando o tipo de coluna usado para uma dimensão é numérico ou string. Se o campo column estiver definido como metric_value, numericBinSize vai substituir maxBinCount.

floatBinSize

number

Opcional. float_bin_size é usado quando o tipo de coluna usado para uma dimensão é uma coluna numérica de ponto flutuante.

Medida

Representação JSON
{
  "column": string,
  "aggregationFunction": {
    object (AggregationFunction)
  }
}
Campos
column

string

Obrigatório. O nome da coluna no conjunto de dados usado para a medida.

aggregationFunction

object (AggregationFunction)

Obrigatório. A função de agregação aplicada à coluna de entrada. Não pode ser definido como "none", a menos que o agrupamento por classes esteja desativado na dimensão. A função de agregação é usada para agrupar pontos nos agrupamentos de dimensão.

AggregationFunction

Representação JSON
{
  "type": string,
  "parameters": [
    {
      object (Parameter)
    }
  ]
}
Campos
type

string

Obrigatório. O tipo de função de agregação precisa ser um dos seguintes:

  • "none": nenhuma função.
  • "percentile" - APPROX_QUANTILES() - 1 valor numérico de parâmetro
  • "average" - AVG()
  • "count" - COUNT()
  • "count-distinct": COUNT(DISTINCT)
  • "count-distinct-approx" - APPROX_COUNT_DISTINCT()
  • "max" - MAX()
  • "min" - MIN()
  • "sum": SUM()
parameters[]

object (Parameter)

Opcional. Parâmetros aplicados à função de agregação. Usado apenas para funções que exigem isso.

Parâmetro

Representação JSON
{

  // Union field value can be only one of the following:
  "intValue": string,
  "doubleValue": number
  // End of list of possible types for union field value.
}
Campos
Campo de união value. Valor de parâmetro. value pode ser apenas de um dos tipos a seguir:
intValue

string (int64 format)

Um valor de parâmetro inteiro.

doubleValue

number

Um valor de parâmetro de ponto flutuante.

Detalhamento

Representação JSON
{
  "column": string,
  "limit": integer,
  "aggregationFunction": {
    object (AggregationFunction)
  },
  "sortOrder": enum (SortOrder)
}
Campos
column

string

Obrigatório. O nome da coluna no conjunto de dados que contém os valores de detalhamento.

limit

integer

Obrigatório. Um limite para o número de detalhamentos. Se for definido como zero, todos os detalhamentos possíveis serão aplicados. A lista de detalhamentos depende do valor do campo sort_order.

aggregationFunction

object (AggregationFunction)

Obrigatório. A função de agregação é aplicada a todos os dados em cada detalhamento criado.

sortOrder

enum (SortOrder)

Obrigatório. A ordem de classificação é aplicada aos valores da coluna de detalhamento.

ColumnSortingOptions

Representação JSON
{
  "column": string,
  "direction": enum (SortOrder)
}
Campos
column

string

Opcional. Nome da coluna para classificar os dados

direction

enum (SortOrder)

Opcional. Uma direção de classificação que determina a ordem crescente ou decrescente. Este é um campo legado mantido para compatibilidade com versões anteriores da tabela.

Limite

Representação JSON
{
  "label": string,
  "value": number,
  "color": enum (Color),
  "direction": enum (Direction),
  "targetAxis": enum (TargetAxis)
}
Campos
label

string

Um rótulo para o limite.

value

number

O valor do limite. O valor precisa ser definido na escala nativa da métrica.

color

enum (Color)

A cor do estado para esse limite. A cor não é permitida em um XyChart.

direction

enum (Direction)

A direção do limite atual. A direção não é permitida em um XyChart.

targetAxis

enum (TargetAxis)

O eixo de destino a ser usado para representar o limite. Não é permitido usar o eixo de destino em um quadro de visão geral.

Axis

Representação JSON
{
  "label": string,
  "scale": enum (Scale)
}
Campos
label

string

O marcador do eixo.

scale

enum (Scale)

A escala do eixo. Por padrão, uma escala linear é usada.

ChartOptions

Representação JSON
{
  "mode": enum (Mode),
  "displayHorizontal": boolean
}
Campos
mode

enum (Mode)

O modo de gráfico.

displayHorizontal

boolean

Prévia: configura se os valores representados no gráfico são mostrados no eixo horizontal ou vertical. Por padrão, os valores são representados no eixo vertical. Este é um recurso de prévia e pode estar sujeito a mudanças antes do lançamento final.

Visão geral

Representação JSON
{
  "timeSeriesQuery": {
    object (TimeSeriesQuery)
  },
  "thresholds": [
    {
      object (Threshold)
    }
  ],
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "measures": [
    {
      object (Measure)
    }
  ],
  "breakdowns": [
    {
      object (Breakdown)
    }
  ],

  // Union field data_view can be only one of the following:
  "gaugeView": {
    object (GaugeView)
  },
  "sparkChartView": {
    object (SparkChartView)
  },
  "blankView": {
    object
  }
  // End of list of possible types for union field data_view.
}
Campos
timeSeriesQuery

object (TimeSeriesQuery)

Obrigatório. Campos para consultar dados de série temporal da API de métricas do Stackdriver.

thresholds[]

object (Threshold)

Os limites usados para determinar o estado da visão geral com base no valor atual da série temporal. Para um valor real x, a visão geral fica em estado de perigo se x for menor ou igual a um limite de perigo que é acionado abaixo ou maior ou igual a um limite de perigo que é acionado acima. Da mesma forma, se x estiver acima/abaixo de um limite de aviso que aciona acima/abaixo, a tabela de pontuação estará em um estado de aviso, a menos que x também a coloque em um estado de perigo. (O perigo é mais importante que o aviso.)

Por exemplo, considere uma visão geral com os quatro limites a seguir:

{
  value: 90,
  category: 'DANGER',
  trigger: 'ABOVE',
},
{
  value: 70,
  category: 'WARNING',
  trigger: 'ABOVE',
},
{
  value: 10,
  category: 'DANGER',
  trigger: 'BELOW',
},
{
  value: 20,
  category: 'WARNING',
  trigger: 'BELOW',
}

Valores menores ou iguais a 10 colocariam o quadro de visão geral em um estado de PERIGO, valores maiores que 10, mas menores ou iguais a 20, em um estado de AVISO, valores estritamente entre 20 e 70 em um estado OK, valores maiores ou iguais a 70, mas menores que 90, em um estado de AVISO e valores maiores ou iguais a 90 em um estado de PERIGO.

dimensions[]

object (Dimension)

Opcional. Uma dimensão é um rótulo, uma classe ou uma categoria estruturada para um conjunto de medições nos seus dados.

measures[]

object (Measure)

Opcional. Uma medida é um valor medido de uma propriedade nos seus dados. Por exemplo, precipitação em polegadas, número de unidades vendidas, receita ganha etc.

breakdowns[]

object (Breakdown)

Opcional. A coleção de detalhamentos a serem aplicados ao conjunto de dados. Um detalhamento é uma forma de segmentar os dados. Por exemplo, é possível detalhar os dados por região.

Campo de união data_view. Define o gráfico adicional opcional mostrado no quadro de visão geral. Se nenhum deles for incluído, um quadro de visão geral padrão será mostrado. data_view pode ser apenas de um dos tipos a seguir:
gaugeView

object (GaugeView)

Faz com que o quadro de visão geral mostre um gráfico de medidor.

sparkChartView

object (SparkChartView)

Faz com que o quadro de visão geral mostre um gráfico sparkline.

blankView

object

Faz com que o Scorecard mostre apenas o valor, sem um indicador do valor em relação aos limites.

GaugeView

Representação JSON
{
  "lowerBound": number,
  "upperBound": number
}
Campos
lowerBound

number

O limite inferior do gráfico de medidor. O valor do gráfico precisa ser sempre maior ou igual a esse.

upperBound

number

O limite máximo do gráfico de medidor. O valor do gráfico precisa ser sempre menor ou igual a esse.

SparkChartView

Representação JSON
{
  "sparkChartType": enum (SparkChartType),
  "minAlignmentPeriod": string
}
Campos
sparkChartType

enum (SparkChartType)

Obrigatório. O tipo de mini gráfico a ser mostrado nesta visualização de gráfico.

minAlignmentPeriod

string (Duration format)

O limite inferior na frequência de pontos de dados no gráfico implementado especificando o período mínimo de alinhamento a ser usado em uma consulta de série temporal. Por exemplo, se os dados forem publicados a cada 10 minutos, não fará sentido buscar e alinhar dados em intervalos de um minuto. Esse campo é opcional e existe apenas como uma dica.

Para consultas em PromQL, esse campo é usado para definir o intervalo mínimo da consulta step, controlando a granularidade dos dados. Valores maiores podem melhorar a performance em intervalos de tempo longos. Consulte Noções básicas de consultas e Consultas de intervalo para mais detalhes sobre o step do PromQL.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

Texto

Representação JSON
{
  "content": string,
  "format": enum (Format),
  "style": {
    object (TextStyle)
  }
}
Campos
content

string

O conteúdo de texto a ser exibido.

format

enum (Format)

Como o conteúdo do texto é formatado.

style

object (TextStyle)

Como o texto é estilizado

TextStyle

Representação JSON
{
  "backgroundColor": string,
  "textColor": string,
  "horizontalAlignment": enum (HorizontalAlignment),
  "verticalAlignment": enum (VerticalAlignment),
  "padding": enum (PaddingSize),
  "fontSize": enum (FontSize),
  "pointerLocation": enum (PointerLocation)
}
Campos
backgroundColor

string

A cor de fundo como uma string hexadecimal. "#RRGGBB" ou "#RGB"

textColor

string

A cor do texto como uma string hexadecimal. "#RRGGBB" ou "#RGB"

horizontalAlignment

enum (HorizontalAlignment)

O alinhamento horizontal do título e do conteúdo

verticalAlignment

enum (VerticalAlignment)

O alinhamento vertical do título e do conteúdo

padding

enum (PaddingSize)

A quantidade de padding ao redor do widget

fontSize

enum (FontSize)

Tamanhos de fonte para o título e o conteúdo. O título ainda será maior em relação ao conteúdo.

pointerLocation

enum (PointerLocation)

A localização do ponteiro para este widget (também chamado de "rabo" às vezes)

AlertChart

Representação JSON
{
  "name": string
}
Campos
name

string

Obrigatório. O nome do recurso da política de alertas. O formato é:

projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[ALERT_POLICY_ID]

TimeSeriesTable

Representação JSON
{
  "dataSets": [
    {
      object (TableDataSet)
    }
  ],
  "metricVisualization": enum (MetricVisualization),
  "columnSettings": [
    {
      object (ColumnSettings)
    }
  ]
}
Campos
dataSets[]

object (TableDataSet)

Obrigatório. Os dados mostrados nesta tabela.

metricVisualization

enum (MetricVisualization)

Opcional. Estratégia de renderização da loja

columnSettings[]

object (ColumnSettings)

Opcional. A lista das configurações de coluna persistentes da tabela.

TableDataSet

Representação JSON
{
  "timeSeriesQuery": {
    object (TimeSeriesQuery)
  },
  "tableTemplate": string,
  "minAlignmentPeriod": string,
  "tableDisplayOptions": {
    object (TableDisplayOptions)
  }
}
Campos
timeSeriesQuery

object (TimeSeriesQuery)

Obrigatório. Campos para consultar dados de série temporal da API de métricas do Stackdriver.

tableTemplate

string

Opcional. Uma string de modelo para nomear TimeSeries no conjunto de dados resultante. Precisa ser uma string com interpolações do formato ${label_name}, que será resolvida como o valor do rótulo, ou seja, "${resource.labels.project_id}".

minAlignmentPeriod

string (Duration format)

Opcional. O limite inferior na frequência de pontos de dados para esse conjunto de dados, implementado especificando o período mínimo de alinhamento a ser usado em uma consulta de série temporal. Por exemplo, se os dados forem publicados uma vez a cada 10 minutos, o min_alignment_period deverá ser de pelo menos 10 minutos. Não faria sentido buscar e alinhar dados em intervalos de um minuto.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

tableDisplayOptions

object (TableDisplayOptions)

Opcional. Opções de exibição de tabela para configurar como ela é renderizada.

TableDisplayOptions

Representação JSON
{
  "shownColumns": [
    string
  ]
}
Campos
shownColumns[]
(deprecated)

string

Opcional. Esse campo não é usado e foi substituído por "TimeSeriesTable.column_settings".

ColumnSettings

Representação JSON
{
  "column": string,
  "visible": boolean,
  "alignment": enum (CellAlignment),
  "displayName": string,
  "thresholds": [
    {
      object (Threshold)
    }
  ]
}
Campos
column

string

Obrigatório. O ID da coluna.

visible

boolean

Obrigatório. Indica se a coluna precisa estar visível no carregamento de página.

alignment

enum (CellAlignment)

Opcional. Indica se a coluna precisa ser alinhada à esquerda, no meio ou à direita.

displayName

string

Opcional. Nome de exibição da coluna

thresholds[]

object (Threshold)

Opcional. Os limites usados para determinar como a célula da tabela deve ser renderizada de acordo com o valor atual da série temporal.

CollapsibleGroup

Representação JSON
{
  "collapsed": boolean
}
Campos
collapsed

boolean

O estado recolhido do widget no primeiro carregamento de página.

LogsPanel

Representação JSON
{
  "filter": string,
  "resourceNames": [
    string
  ]
}
Campos
filter

string

Um filtro que escolhe quais entradas de registro serão retornadas. Consulte Consultas avançadas de registros. Somente as entradas de registro que correspondem ao filtro são retornadas. Um filtro vazio corresponde a todas as entradas de registro.

resourceNames[]

string

Os nomes dos recursos de geração de registros para coletar registros. No momento, projetos e visualizações de armazenamento são aceitos. Se estiver vazio, o widget vai usar o projeto host por padrão.

IncidentList

Representação JSON
{
  "monitoredResources": [
    {
      object (MonitoredResource)
    }
  ],
  "policyNames": [
    string
  ]
}
Campos
monitoredResources[]

object (MonitoredResource)

Opcional. O recurso monitorado para o qual os incidentes são listados. O recurso não precisa ser totalmente especificado. Ou seja, você pode especificar o tipo de recurso, mas não os valores dos rótulos de recursos. O tipo de recurso e os rótulos são usados para filtragem.

policyNames[]

string

Opcional. Uma lista de nomes de políticas de alertas para filtrar a lista de incidentes. Não inclua o prefixo do ID do projeto no nome da política. Por exemplo, use alertPolicies/utilization.

MonitoredResource

Representação JSON
{
  "type": string,
  "labels": {
    string: string,
    ...
  }
}
Campos
type

string

Obrigatório. O tipo de recurso monitorado. Este campo precisa corresponder ao campo type de um objeto MonitoredResourceDescriptor. Por exemplo, o tipo de uma instância de VM do Compute Engine é gce_instance. Para uma lista de tipos, consulte Tipos de recursos do Monitoring e Tipos de recursos do Logging.

labels

map (key: string, value: string)

Obrigatório. Valores para todos os rótulos listados no descritor de recurso monitorado associado. Por exemplo, as instâncias de VM do Compute Engine usam os rótulos "project_id", "instance_id" e "zone".

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

LabelsEntry

Representação JSON
{
  "key": string,
  "value": string
}
Campos
key

string

value

string

PieChart

Representação JSON
{
  "dataSets": [
    {
      object (PieChartDataSet)
    }
  ],
  "chartType": enum (PieChartType),
  "showLabels": boolean
}
Campos
dataSets[]

object (PieChartDataSet)

Obrigatório. As consultas para os dados do gráfico.

chartType

enum (PieChartType)

Obrigatório. Indica o tipo de visualização do PieChart.

showLabels

boolean

Opcional. Indica se o gráfico de pizza deve mostrar ou não os rótulos das fatias.

PieChartDataSet

Representação JSON
{
  "timeSeriesQuery": {
    object (TimeSeriesQuery)
  },
  "sliceNameTemplate": string,
  "minAlignmentPeriod": string,
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "measures": [
    {
      object (Measure)
    }
  ]
}
Campos
timeSeriesQuery

object (TimeSeriesQuery)

Obrigatório. A consulta para o PieChart. Consulte google.monitoring.dashboard.v1.TimeSeriesQuery.

sliceNameTemplate

string

Opcional. Um modelo para o nome da fração. Esse nome vai aparecer na legenda e na dica do gráfico de pizza. Ele substitui os nomes gerados automaticamente para as divisões. Por exemplo, se o modelo estiver definido como ${resource.labels.zone}, o valor da zona será usado para o nome em vez do nome padrão.

minAlignmentPeriod

string (Duration format)

Opcional. O limite inferior na frequência de pontos de dados para esse conjunto de dados, implementado especificando o período mínimo de alinhamento a ser usado em uma consulta de série temporal. Por exemplo, se os dados forem publicados a cada 10 minutos, o min_alignment_period deverá ser de pelo menos 10 minutos. Não faria sentido buscar e alinhar dados em intervalos de um minuto.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

dimensions[]

object (Dimension)

Uma dimensão é um rótulo, uma classe ou uma categoria estruturada para um conjunto de medições nos seus dados.

measures[]

object (Measure)

Uma medida é um valor medido de uma propriedade nos seus dados. Por exemplo, precipitação em polegadas, número de unidades vendidas, receita ganha etc.

Mapa de árvore

Representação JSON
{
  "dataSets": [
    {
      object (TreemapDataSet)
    }
  ],
  "treemapHierarchy": [
    string
  ]
}
Campos
dataSets[]

object (TreemapDataSet)

Obrigatório. A coleção de conjuntos de dados usada para construir e preencher o mapa de árvore. Para os retângulos renderizados do mapa de árvore:

  • A cor é determinada pelo valor agregado de cada agrupamento.
  • O tamanho é proporcional à contagem de série temporal agregadas no segmento do retângulo.
treemapHierarchy[]

string

Obrigatório. Rótulos ordenados que representam a estrutura hierárquica do mapa de árvore.

TreemapDataSet

Representação JSON
{
  "timeSeriesQuery": {
    object (TimeSeriesQuery)
  },
  "measures": [
    {
      object (Measure)
    }
  ],
  "breakdowns": [
    {
      object (Breakdown)
    }
  ]
}
Campos
timeSeriesQuery

object (TimeSeriesQuery)

Obrigatório. A consulta que busca os dados relevantes. Ver google.monitoring.dashboard.v1.TimeSeriesQuery

measures[]

object (Measure)

Opcional. Uma coleção de medidas. Uma medida é um valor medido de uma propriedade nos seus dados. Por exemplo, precipitação em polegadas, número de unidades vendidas, receita ganha etc.

breakdowns[]

object (Breakdown)

Opcional. A coleção de detalhamentos a serem aplicados ao conjunto de dados. Um detalhamento é uma forma de segmentar os dados. Por exemplo, é possível detalhar os dados por região.

ErrorReportingPanel

Representação JSON
{
  "projectNames": [
    string
  ],
  "services": [
    string
  ],
  "versions": [
    string
  ]
}
Campos
projectNames[]

string

O nome do recurso do projeto do Google Cloud Platform. Escrito como projects/{projectID} ou projects/{projectNumber}, em que {projectID} e {projectNumber} podem ser encontrados no console do Google Cloud.

Exemplos: projects/my-project-123, projects/5551234.

services[]

string

Um identificador do serviço, como o nome do executável, do job ou do serviço do Google App Engine. Espera-se que esse campo tenha um número baixo de valores relativamente estáveis ao longo do tempo, ao contrário de version, que pode ser alterado sempre que um novo código é implantado.

Contém o nome do serviço para relatórios de erros extraídos dos registros do Google App Engine ou default se o serviço padrão do App Engine for usado.

versions[]

string

Representa a versão do código-fonte fornecida pelo desenvolvedor, que pode representar um rótulo de versão ou um hash SHA-1 do Git, por exemplo. No ambiente padrão do App Engine, a versão é definida como a versão do app.

SectionHeader

Representação JSON
{
  "subtitle": string,
  "dividerBelow": boolean
}
Campos
subtitle

string

O subtítulo da seção

dividerBelow

boolean

Se uma divisória será inserida abaixo da seção no sumário

SingleViewGroup

Representação JSON
{
  "displayType": enum (DisplayType)
}
Campos
displayType

enum (DisplayType)

Opcional. Determina como o seletor de widget será exibido.

FilterControl

Representação JSON
{
  "templateVariable": string
}
Campos
templateVariable

string

Nome da variável de modelo afetada pelo widget.

VisibilityCondition

Representação JSON
{
  "templateVariableCondition": {
    object (TemplateVariableCondition)
  }
}
Campos
templateVariableCondition

object (TemplateVariableCondition)

Uma condição cuja avaliação é baseada no valor de uma variável de modelo.

TemplateVariableCondition

Representação JSON
{
  "templateVariable": string,
  "templateVariableValue": string,
  "comparator": enum (Comparator)
}
Campos
templateVariable

string

A variável de modelo cujo valor é avaliado.

templateVariableValue

string

O valor a ser comparado com a variável de modelo. Por exemplo, se o comparador for REGEX_FULL_MATCH, esse campo vai conter uma expressão regular.

comparator

enum (Comparator)

Comparador usado para avaliar se o valor da variável de modelo corresponde ao template_variable_value. Por exemplo, se o comparador for REGEX_FULL_MATCH, "template_variable_value" vai conter uma regex que será comparada com o valor da variável de modelo.

TimeRange

Representação JSON
{

  // Union field time_interval can be only one of the following:
  "absoluteWindow": {
    object (Interval)
  },
  "relativeDuration": string
  // End of list of possible types for union field time_interval.
}
Campos
Campo de união time_interval. Especifica o tipo de intervalo de período. time_interval pode ser apenas de um dos tipos a seguir:
absoluteWindow

object (Interval)

Opcional. Representa um período com horários de início e término absolutos. O horário de início é inclusivo, e o horário de término é exclusivo.

relativeDuration

string (Duration format)

Opcional. Especifica a duração usada para mudar os dados em relação ao horário atual como o horário de término. A duração precisa ser positiva.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

MosaicLayout

Representação JSON
{
  "columns": integer,
  "tiles": [
    {
      object (Tile)
    }
  ]
}
Campos
columns

integer

O número de colunas na grade de mosaico. O número de colunas precisa estar entre 1 e 48, incluindo esses dois valores.

tiles[]

object (Tile)

Os blocos a serem exibidos.

Bloco

Representação JSON
{
  "xPos": integer,
  "yPos": integer,
  "width": integer,
  "height": integer,
  "widget": {
    object (Widget)
  }
}
Campos
xPos

integer

A posição indexada em zero do bloco em blocos de grade em relação à borda esquerda da grade. Os blocos precisam estar dentro do número especificado de colunas. x_pos não pode ser negativo.

yPos

integer

A posição indexada em zero do bloco na grade em relação à borda superior dela. y_pos não pode ser negativo.

width

integer

A largura do bloco, medida em blocos da grade. Os blocos precisam ter uma largura mínima de 1.

height

integer

A altura do bloco, medida em blocos da grade. Os blocos precisam ter uma altura mínima de 1.

widget

object (Widget)

O widget informativo contido no bloco. Por exemplo, um XyChart.

RowLayout

Representação JSON
{
  "rows": [
    {
      object (Row)
    }
  ]
}
Campos
rows[]

object (Row)

As linhas de conteúdo a serem mostradas.

Linha

Representação JSON
{
  "weight": string,
  "widgets": [
    {
      object (Widget)
    }
  ]
}
Campos
weight

string (int64 format)

O peso relativo desta linha. O peso da linha é usado para ajustar a altura das linhas na tela (em relação aos elementos semelhantes). Quanto maior o peso, maior a altura da linha na tela. Se omitido, um valor de 1 será usado durante a renderização.

widgets[]

object (Widget)

Os widgets de exibição organizados horizontalmente nessa linha.

ColumnLayout

Representação JSON
{
  "columns": [
    {
      object (Column)
    }
  ]
}
Campos
columns[]

object (Column)

As colunas de conteúdo a serem mostradas.

Coluna

Representação JSON
{
  "weight": string,
  "widgets": [
    {
      object (Widget)
    }
  ]
}
Campos
weight

string (int64 format)

A ponderação relativa desta coluna. O peso da coluna é usado para ajustar a largura das colunas na tela (em relação aos elementos semelhantes). Quanto maior o peso, maior a largura da coluna na tela. Se omitido, um valor de 1 será usado durante a renderização.

widgets[]

object (Widget)

Os widgets de exibição organizados verticalmente nesta coluna.

DashboardFilter

Representação JSON
{
  "labelKey": string,
  "templateVariable": string,
  "valueType": enum (ValueType),
  "filterType": enum (FilterType),

  // Union field default_value can be only one of the following:
  "stringValue": string,
  "stringArrayValue": {
    object (StringArray)
  }
  // End of list of possible types for union field default_value.

  // Union field value_source can be only one of the following:
  "timeSeriesQuery": {
    object (TimeSeriesQuery)
  },
  "stringArray": {
    object (StringArray)
  }
  // End of list of possible types for union field value_source.
}
Campos
labelKey

string

Opcional. A chave do rótulo. Ele precisa ser omitido se o "filter_type" for "VALUE_ONLY", mas é obrigatório caso contrário.

templateVariable

string

O texto do marcador de posição que pode ser referenciado em uma string de filtro ou consulta MQL. Se omitido, o filtro do painel será aplicado a todos os widgets relevantes no painel.

valueType

enum (ValueType)

O tipo do valor do filtro. Se "value_type" não for fornecido, ele será inferido de "default_value". Se nem value_type nem default_value forem fornecidos, value_type será definido como STRING por padrão.

filterType

enum (FilterType)

O tipo de filtro especificado

Campo de união default_value. O valor padrão usado na comparação de filtro default_value pode ser apenas um dos seguintes:
stringValue

string

Um valor de string de comprimento variável. Se esse campo for definido, "value_type" precisará ser definido como "STRING" ou "VALUE_TYPE_UNSPECIFIED".

stringArrayValue

object (StringArray)

Uma matriz de valores de string de comprimento variável. Se esse campo for definido, "value_type" precisará ser definido como "STRING_ARRAY" ou "VALUE_TYPE_UNSPECIFIED".

Campo de união value_source. Uma definição do conjunto de valores válidos para o filtro. Isso é opcional, mas recomendado para filtros VALUE_ONLY. Para outros tipos de filtros, o conjunto de valores válidos será inferido dos dados representados no gráfico. value_source pode ser apenas de um dos tipos a seguir:
timeSeriesQuery

object (TimeSeriesQuery)

Uma consulta para buscar os valores possíveis do filtro. Somente OpsAnalyticsQueries são compatíveis

stringArray

object (StringArray)

Uma lista de possíveis valores de string para o filtro.

StringArray

Representação JSON
{
  "values": [
    string
  ]
}
Campos
values[]

string

Os valores da matriz

LabelsEntry

Representação JSON
{
  "key": string,
  "value": string
}
Campos
key

string

value

string

DashboardAnnotations

Representação JSON
{
  "defaultResourceNames": [
    string
  ],
  "eventAnnotations": [
    {
      object (EventAnnotation)
    }
  ]
}
Campos
defaultResourceNames[]

string

Padrões no nível do painel para nomes de recursos de geração de registros a serem pesquisados para eventos. No momento, apenas projetos são aceitos. Cada EventAnnotation individual pode ter substituições próprias. Se este campo e o campo por anotação estiverem vazios, o projeto de escopo será usado. Limite: 50 projetos. Exemplo:

“projects/some-project-id”
eventAnnotations[]

object (EventAnnotation)

Lista de configurações de anotação para este painel. Cada entrada especifica um tipo de evento.

EventAnnotation

Representação JSON
{
  "displayName": string,
  "eventType": enum (EventType),
  "filter": string,
  "enabled": boolean,
  "resourceNames": [
    string
  ]
}
Campos
displayName

string

Somente para exibição UI. Não pode ser usado de forma programática.

eventType

enum (EventType)

O tipo de evento a ser mostrado.

filter

string

string que filtra os eventos, dependente do evento. Valores de exemplo:

"resource.labels.pod_name = 'pod-1'"
"protoPayload.authenticationInfo.principalEmail='user@example.com'"
enabled

boolean

Define se os eventos vão aparecer no painel por padrão.

resourceNames[]

string

Substituição por nível de anotação para os nomes dos recursos de geração de registros em que os eventos serão pesquisados. No momento, apenas projetos são aceitos. Se este campo e o campo por anotação estiverem vazios, o padrão será o projeto host. Limite: 50 projetos. Exemplo:

“projects/another-project-id”

Alinhador

O Aligner especifica a operação que será aplicada aos pontos de dados em cada período de alinhamento de uma série temporal. Com exceção de ALIGN_NONE, que especifica que nenhuma operação seja aplicada, cada operação de alinhamento substitui o conjunto de valores de dados em cada período de alinhamento por um único valor: o resultado da aplicação da operação aos valores de dados. Uma série temporal alinhada tem um único valor de dados no final de cada alignment_period.

Uma operação de alinhamento também pode mudar o tipo de dado dos valores. Por exemplo, se você aplicar uma operação de contagem a valores booleanos, os dados value_type na série temporal original serão BOOLEAN, mas o value_type no resultado alinhado será INT64.

Tipos enumerados
ALIGN_NONE Sem alinhamento. Os dados brutos são retornados. Não é válido se uma redução entre séries for solicitada. O value_type do resultado é o mesmo que o value_type da entrada.
ALIGN_DELTA

Alinhe e converta para DELTA. A resposta é delta = y1 - y0.

Esse alinhamento é válido para as métricas CUMULATIVE e DELTA. Se o período de alinhamento selecionado resultar em períodos sem dados, o valor alinhado será criado por interpolação. O value_type do resultado alinhado é o mesmo que o value_type da entrada.

ALIGN_RATE

Alinhe e converta em uma taxa. O resultado é calculado como rate = (y1 - y0)/(t1 - t0), ou "delta ao longo do tempo". Pense nesse alinhador como fornecendo a inclinação da linha que passa pelo valor no início e no fim do alignment_period.

Esse alinhador é válido para métricas CUMULATIVE e DELTA com valores numéricos. Se o período de alinhamento selecionado resultar em períodos sem dados, o valor alinhado será criado por interpolação. A saída é uma métrica GAUGE com value_type DOUBLE.

Se, por "taxa", você quiser dizer "mudança percentual", consulte o alinhador ALIGN_PERCENT_CHANGE.

ALIGN_INTERPOLATE Alinhe por interpolação entre pontos adjacentes em torno do limite do período de alinhamento. Esse alinhador é válido para métricas GAUGE com valores numéricos. O value_type do resultado alinhado é o mesmo que o value_type da entrada.
ALIGN_NEXT_OLDER Alinhe movendo o ponto de dados mais recente antes do final do período de alinhamento para o limite no final do período de alinhamento. Esse alinhador é válido para GAUGE métricas. O value_type do resultado alinhado é o mesmo que o value_type da entrada.
ALIGN_MIN Alinhe a série temporal retornando o valor mínimo em cada período de alinhamento. Esse alinhador é válido para métricas GAUGE e DELTA com valores numéricos. O value_type do resultado alinhado é o mesmo que o value_type da entrada.
ALIGN_MAX Alinha a série temporal retornando o valor máximo em cada período de alinhamento. Esse alinhador é válido para métricas GAUGE e DELTA com valores numéricos. O value_type do resultado alinhado é o mesmo que o value_type da entrada.
ALIGN_MEAN Alinhe a série temporal retornando o valor médio em cada período de alinhamento. Esse alinhador é válido para métricas GAUGE e DELTA com valores numéricos. O value_type do resultado alinhado é DOUBLE.
ALIGN_COUNT Alinhe a série temporal retornando o número de valores em cada período de alinhamento. Esse alinhador é válido para métricas GAUGE e DELTA com valores numéricos ou booleanos. O value_type do resultado alinhado é INT64.
ALIGN_SUM Alinhe a série temporal retornando a soma dos valores em cada período de alinhamento. Esse alinhador é válido para métricas GAUGE e DELTA com valores numéricos e de distribuição. O value_type do resultado alinhado é o mesmo que o value_type da entrada.
ALIGN_STDDEV Alinhe a série temporal retornando o desvio padrão dos valores em cada período de alinhamento. Esse alinhador é válido para métricas GAUGE e DELTA com valores numéricos. O value_type da saída é DOUBLE.
ALIGN_COUNT_TRUE Alinhe a série temporal retornando o número de valores True em cada período de alinhamento. Esse alinhador é válido para métricas GAUGE com valores booleanos. O value_type da saída é INT64.
ALIGN_COUNT_FALSE Alinhe a série temporal retornando o número de valores False em cada período de alinhamento. Esse alinhador é válido para métricas GAUGE com valores booleanos. O value_type da saída é INT64.
ALIGN_FRACTION_TRUE Alinhe a série temporal retornando a proporção do número de valores True para o número total de valores em cada período de alinhamento. Esse alinhador é válido para métricas GAUGE com valores booleanos. O valor de saída está no intervalo [0,0, 1,0] e tem value_type DOUBLE.
ALIGN_PERCENTILE_99 Alinhe as série temporal usando a agregação de percentil. O ponto de dados resultante em cada período de alinhamento é o 99º percentil de todos os pontos de dados no período. Esse alinhador é válido para métricas GAUGE e DELTA com valores de distribuição. A saída é uma métrica GAUGE com value_type DOUBLE.
ALIGN_PERCENTILE_95 Alinhe as série temporal usando a agregação de percentil. O ponto de dados resultante em cada período de alinhamento é o 95º percentil de todos os pontos de dados no período. Esse alinhador é válido para métricas GAUGE e DELTA com valores de distribuição. A saída é uma métrica GAUGE com value_type DOUBLE.
ALIGN_PERCENTILE_50 Alinhe as série temporal usando a agregação de percentil. O ponto de dados resultante em cada período de alinhamento é o 50º percentil de todos os pontos de dados no período. Esse alinhador é válido para métricas GAUGE e DELTA com valores de distribuição. A saída é uma métrica GAUGE com value_type DOUBLE.
ALIGN_PERCENTILE_05 Alinhe as série temporal usando a agregação de percentil. O ponto de dados resultante em cada período de alinhamento é o 5º percentil de todos os pontos de dados no período. Esse alinhador é válido para métricas GAUGE e DELTA com valores de distribuição. A saída é uma métrica GAUGE com value_type DOUBLE.
ALIGN_PERCENT_CHANGE

Alinhe e converta para uma mudança percentual. Esse alinhador é válido para métricas GAUGE e DELTA com valores numéricos. Esse alinhamento retorna ((current - previous)/previous) * 100, em que o valor de previous é determinado com base no alignment_period.

Se os valores de current e previous forem 0, o valor retornado será 0. Se apenas previous for 0, o valor retornado será infinito.

Uma média móvel de 10 minutos é calculada em cada ponto do período de alinhamento antes do cálculo acima para suavizar a métrica e evitar falsos positivos de picos muito curtos. A média móvel só é aplicável a dados com valores >= 0. Todos os valores < 0 são tratados como um ponto de dados ausente e são ignorados. Embora as métricas DELTA sejam aceitas por esse alinhamento, é preciso ter cuidado para que os valores da métrica sejam sempre positivos. A saída é uma métrica GAUGE com value_type DOUBLE.

Redutor

Uma operação de redução descreve como agregar pontos de dados de várias séries temporais em uma única série temporal, em que o valor de cada ponto de dados na série resultante é uma função de todos os valores já alinhados nas séries temporais de entrada.

Tipos enumerados
REDUCE_NONE Sem redução entre série temporal. A saída do Aligner é retornada.
REDUCE_MEAN Reduza calculando o valor médio nas série temporal de cada período de alinhamento. Esse redutor é válido para métricas DELTA e GAUGE com valores numéricos ou de distribuição. O value_type da saída é DOUBLE.
REDUCE_MIN Reduza calculando o valor mínimo nas série temporal para cada período de alinhamento. Esse redutor é válido para métricas DELTA e GAUGE com valores numéricos. O value_type da saída é igual ao value_type da entrada.
REDUCE_MAX Reduza calculando o valor máximo em série temporal para cada período de alinhamento. Esse redutor é válido para métricas DELTA e GAUGE com valores numéricos. O value_type da saída é igual ao value_type da entrada.
REDUCE_SUM Reduza calculando a soma em série temporal para cada período de alinhamento. Esse redutor é válido para métricas DELTA e GAUGE com valores numéricos e de distribuição. O value_type da saída é igual ao value_type da entrada.
REDUCE_STDDEV Reduza calculando o desvio padrão nas série temporal de cada período de alinhamento. Esse redutor é válido para métricas DELTA e GAUGE com valores numéricos ou de distribuição. O value_type da saída é DOUBLE.
REDUCE_COUNT Faça a redução calculando o número de pontos de dados em série temporal para cada período de alinhamento. Esse redutor é válido para métricas DELTA e GAUGE de value_type numéricos, booleanos, de distribuição e de string. O value_type da saída é INT64.
REDUCE_COUNT_TRUE Faça a redução calculando o número de pontos de dados com valor True em série temporal para cada período de alinhamento. Esse redutor é válido para métricas DELTA e GAUGE de value_type booleano. O value_type da saída é INT64.
REDUCE_COUNT_FALSE Faça a redução calculando o número de pontos de dados com valor False em série temporal para cada período de alinhamento. Esse redutor é válido para métricas DELTA e GAUGE de value_type booleano. O value_type da saída é INT64.
REDUCE_FRACTION_TRUE Faça a redução calculando a proporção do número de pontos de dados com valor True para o número total de pontos de dados em cada período de alinhamento. Esse redutor é válido para métricas DELTA e GAUGE de value_type booleano. O valor de saída está no intervalo [0,0, 1,0] e tem value_type DOUBLE.
REDUCE_PERCENTILE_99 Faça a redução calculando o 99º percentil de pontos de dados em série temporal para cada período de alinhamento. Esse redutor é válido para métricas GAUGE e DELTA de tipo numérico e de distribuição. O valor da saída é DOUBLE.
REDUCE_PERCENTILE_95 Reduza calculando o 95º percentil dos pontos de dados em série temporal para cada período de alinhamento. Esse redutor é válido para métricas GAUGE e DELTA de tipo numérico e de distribuição. O valor da saída é DOUBLE.
REDUCE_PERCENTILE_50 Faça a redução calculando o 50º percentil dos pontos de dados em série temporal para cada período de alinhamento. Esse redutor é válido para métricas GAUGE e DELTA de tipo numérico e de distribuição. O valor da saída é DOUBLE.
REDUCE_PERCENTILE_05 Reduza calculando o 5º percentil dos pontos de dados em série temporal para cada período de alinhamento. Esse redutor é válido para métricas GAUGE e DELTA de tipo numérico e de distribuição. O valor da saída é DOUBLE.

Método

Os redutores de valor que podem ser aplicados a um PickTimeSeriesFilter.

Tipos enumerados
METHOD_UNSPECIFIED Não permitido. É necessário especificar um Method diferente se você especificar um PickTimeSeriesFilter.
METHOD_MEAN Selecione a média de todos os valores.
METHOD_MAX Selecione o valor máximo.
METHOD_MIN Selecione o valor mínimo.
METHOD_SUM Calcule a soma de todos os valores.
METHOD_LATEST Selecione o valor mais recente.

Direção

Descreve as direções de classificação.

Tipos enumerados
DIRECTION_UNSPECIFIED Não permitido. É necessário especificar um Direction diferente se você especificar um PickTimeSeriesFilter.
TOP Transmita as entradas de classificação mais altas do num_time_series.
BOTTOM Transmita as entradas de classificação num_time_series mais baixas.

Método

Os métodos de filtragem que podem ser aplicados a um fluxo.

Tipos enumerados
METHOD_UNSPECIFIED Não é permitido em solicitações bem formadas.
METHOD_CLUSTER_OUTLIER Calcule a pontuação de outlier de cada stream.

SpanDataValue

Lista de diferentes valores de dados de período usados para determinar os dados mostrados no gráfico.

Tipos enumerados
SPAN_DATA_VALUE_UNSPECIFIED É necessário ter um valor UNSPECIFIED para enums. Isso não deve ser usado na prática.
SPAN_COUNT Valor de dados de contagem de períodos
SPAN_DURATION Valor de dados de duração do período
SPAN_DURATION_PERCENTILES Valor de dados de percentis de duração do período

PlotType

Os tipos de estratégias de criação de gráficos para conjuntos de dados.

Tipos enumerados
PLOT_TYPE_UNSPECIFIED O tipo de gráfico não foi especificado. A visualização vai usar LINE como padrão.
LINE Os dados são representados como um conjunto de linhas (uma linha por série).
STACKED_AREA Os dados são representados como um conjunto de áreas preenchidas (uma área por série), com as áreas empilhadas verticalmente (a base de cada área é a parte superior da área anterior, e a base da primeira área é o eixo x). Como as áreas não se sobrepõem, cada uma é preenchida com uma cor opaca diferente.
STACKED_BAR Os dados são representados como um conjunto de caixas retangulares (uma caixa por série), com as caixas empilhadas verticalmente (a base de cada caixa é a parte superior da anterior, e a base da primeira caixa é o eixo x). Como as caixas não se sobrepõem, cada uma é preenchida com uma cor opaca diferente.
HEATMAP Os dados são representados como um mapa de calor. A série que está sendo representada precisa ter um tipo de valor DISTRIBUTION. O valor de cada bucket na distribuição é mostrado como uma cor. No momento, esse tipo não está disponível no aplicativo Stackdriver Monitoring.

TargetAxis

Um identificador de eixo.

Tipos enumerados
TARGET_AXIS_UNSPECIFIED O eixo de destino não foi especificado. O padrão é Y1.
Y1 O y_axis (o eixo direito do gráfico).
Y2 O y2_axis (o eixo esquerdo do gráfico).

SortOrder

Opções de ordem de classificação.

Tipos enumerados
SORT_ORDER_UNSPECIFIED Uma ordem de classificação não especificada. Essa opção é inválida quando a classificação é obrigatória.
SORT_ORDER_NONE Nenhuma classificação é aplicada.
SORT_ORDER_ASCENDING As entradas de menor valor são selecionadas primeiro.
SORT_ORDER_DESCENDING As entradas de maior valor são selecionadas primeiro.

Cor

A cor sugere uma interpretação ao espectador quando os valores reais cruzam o limite. Os comentários em cada cor fornecem orientação de UX sobre como os usuários podem interpretar uma determinada cor de estado.

Tipos enumerados
COLOR_UNSPECIFIED A cor não foi especificada. Não é permitido em solicitações bem formadas.
YELLOW Ultrapassar o limite é um comportamento "preocupante".
RED Ultrapassar o limite é um comportamento de "emergência".

Direção

Se o limite é considerado cruzado por um valor real acima ou abaixo do valor de limite.

Tipos enumerados
DIRECTION_UNSPECIFIED Não é permitido em solicitações bem formadas.
ABOVE O limite será considerado ultrapassado se o valor real estiver acima do valor do limite.
BELOW O limite será considerado ultrapassado se o valor real estiver abaixo do valor de limite.

TargetAxis

Um identificador de eixo.

Tipos enumerados
TARGET_AXIS_UNSPECIFIED O eixo de destino não foi especificado. O padrão é Y1.
Y1 O y_axis (o eixo direito do gráfico).
Y2 O y2_axis (o eixo esquerdo do gráfico).

Escala

Tipos de escalas usadas nos eixos.

Tipos enumerados
SCALE_UNSPECIFIED A escala não foi especificada. A visualização vai usar LINEAR como padrão.
LINEAR Escala linear.
LOG10 Escala logarítmica (base 10).

Modo

Opções do modo de gráfico.

Tipos enumerados
MODE_UNSPECIFIED O modo não foi especificado. A visualização vai usar COLOR como padrão.
COLOR O gráfico distingue as séries de dados usando cores diferentes. As cores das linhas podem ser reutilizadas quando há muitas linhas no gráfico.
X_RAY O gráfico usa o modo X-ray do Stackdriver, em que cada conjunto de dados é representado usando a mesma cor semitransparente.
STATS O gráfico mostra estatísticas como média, mediana, 95º percentil e muito mais.

SparkChartType

Define os possíveis tipos de minigráficos compatíveis com o Scorecard.

Tipos enumerados
SPARK_CHART_TYPE_UNSPECIFIED Não é permitido em solicitações bem formadas.
SPARK_LINE O minigráfico será renderizado como um pequeno gráfico de linhas.
SPARK_BAR O sparkbar será renderizado como um pequeno gráfico de barras.

Formatar

O tipo de formato do conteúdo de texto.

Tipos enumerados
FORMAT_UNSPECIFIED O formato não foi especificado. O padrão é MARKDOWN.
MARKDOWN O texto contém formatação Markdown.
RAW O texto não tem formatação especial.

HorizontalAlignment

O alinhamento horizontal do título e do conteúdo em um widget de texto.

Tipos enumerados
HORIZONTAL_ALIGNMENT_UNSPECIFIED Nenhum alinhamento horizontal especificado. O padrão é H_LEFT.
H_LEFT Alinhar à esquerda
H_CENTER Alinhar ao centro
H_RIGHT Alinhar à direita

VerticalAlignment

O alinhamento vertical do título e do conteúdo em um widget de texto

Tipos enumerados
VERTICAL_ALIGNMENT_UNSPECIFIED Nenhum alinhamento vertical especificado. O padrão será V_TOP.
V_TOP Alinhar acima
V_CENTER Alinhar ao centro
V_BOTTOM Alinhar abaixo

PaddingSize

Especifica o tamanho do padding ao redor de um widget de texto.

Tipos enumerados
PADDING_SIZE_UNSPECIFIED Nenhum tamanho de padding especificado. O padrão será P_EXTRA_SMALL.
P_EXTRA_SMALL Padding extrapequeno
P_SMALL Padding pequeno
P_MEDIUM Padding médio
P_LARGE Padding grande
P_EXTRA_LARGE Padding extragrande

FontSize

Especifica um tamanho de fonte para o título e o conteúdo de um widget de texto.

Tipos enumerados
FONT_SIZE_UNSPECIFIED Nenhum tamanho de fonte especificado. O padrão será FS_LARGE.
FS_EXTRA_SMALL Tamanho de fonte muito pequeno
FS_SMALL Tamanho pequeno de fonte
FS_MEDIUM Tamanho médio de fonte
FS_LARGE Tamanho grande da fonte
FS_EXTRA_LARGE Tamanho da fonte extra grande

PointerLocation

Especifica onde um ponteiro visual é colocado em um widget de texto (também chamado de "cauda").

Tipos enumerados
POINTER_LOCATION_UNSPECIFIED Nenhum ponteiro visual
PL_TOP Colocado no meio da parte de cima do widget
PL_RIGHT Colocado no meio do lado direito do widget
PL_BOTTOM Colocado no meio da parte de baixo do widget
PL_LEFT Posicionado no meio do lado esquerdo do widget
PL_TOP_LEFT Colocado no lado esquerdo da parte de cima do widget
PL_TOP_RIGHT Colocado no lado direito da parte de cima do widget
PL_RIGHT_TOP Colocado na parte de cima do lado direito do widget
PL_RIGHT_BOTTOM Localizado na parte de baixo do lado direito do widget
PL_BOTTOM_RIGHT Colocado no lado direito da parte de baixo do widget
PL_BOTTOM_LEFT Colocado no lado esquerdo da parte de baixo do widget
PL_LEFT_BOTTOM Colocado na parte de baixo do lado esquerdo do widget
PL_LEFT_TOP Colocado na parte de cima do lado esquerdo do widget

MetricVisualization

Enumeração para metric_visualization de métricas

Tipos enumerados
METRIC_VISUALIZATION_UNSPECIFIED Estado não especificado
NUMBER Renderização de texto padrão
BAR Renderização de barras horizontais

CellAlignment

O alinhamento horizontal das células da tabela nessa coluna

Tipos enumerados
CELL_ALIGNMENT_UNSPECIFIED Nenhum alinhamento horizontal especificado. Retorne ao comportamento padrão. Os valores de rótulo estão alinhados à esquerda. Os valores numéricos são alinhados à direita.
LEFT Alinhar à esquerda
CENTER Alinhar ao centro
RIGHT Alinhar à direita

PieChartType

Tipos para o gráfico de pizza.

Tipos enumerados
PIE_CHART_TYPE_UNSPECIFIED O valor zero. Nenhum tipo especificado. Não use.
PIE Um PieChart do tipo Pie.
DONUT Semelhante ao PIE, mas o PieChart do tipo DONUT tem um buraco no meio.

DisplayType

Um tipo que indica como o seletor de widget será exibido.

Tipos enumerados
DISPLAY_TYPE_UNSPECIFIED O tipo de tela não foi especificado. O padrão é "menu suspenso".
DROPDOWN Renderiza o seletor de widget como um menu suspenso.
TAB Renderiza o seletor de widgets como uma lista de guias.

Comparador

Opções de comparador para avaliar quando o valor da variável de modelo corresponde.

Tipos enumerados
COMPARATOR_UNSPECIFIED Nenhum comparador especificado. O comportamento padrão é REGEX_FULL_MATCH.
REGEX_FULL_MATCH A condição com esse comparador é avaliada como verdadeira quando o valor das variáveis de modelo corresponde à regex especificada.

ValueType

O tipo do valor do filtro

Tipos enumerados
VALUE_TYPE_UNSPECIFIED O tipo de valor não foi especificado
STRING Tipo string
STRING_ARRAY Tipo de matriz de strings

FilterType

O tipo do filtro do painel

Tipos enumerados
FILTER_TYPE_UNSPECIFIED O tipo de filtro não foi especificado. Isso não é válido em uma solicitação bem formada.
RESOURCE_LABEL Filtrar por um valor de rótulo de recurso
METRIC_LABEL Filtrar por um valor de rótulo de métrica
USER_METADATA_LABEL Filtrar por um valor de identificador de metadados do usuário
SYSTEM_METADATA_LABEL Filtrar por um valor de rótulo de metadados do sistema
GROUP Filtrar por um ID de grupo
VALUE_ONLY Filtro que contém apenas um valor. O campo "label_key" não pode ser definido para filtros desse tipo.

EventType

Tipos de evento predefinidos.

Tipos enumerados
EVENT_TYPE_UNSPECIFIED Nenhum tipo de evento especificado.
GKE_WORKLOAD_DEPLOYMENT Patch/atualização da carga de trabalho do GKE.
GKE_POD_CRASH Eventos de falha de um pod do GKE.
GKE_POD_UNSCHEDULABLE Falhas de programação para pods do GKE.
GKE_CONTAINER_CREATION_FAILED Falha ao criar um contêiner do GKE.
GKE_CLUSTER_CREATE_DELETE Criação/exclusão de um cluster do GKE.
GKE_CLUSTER_UPDATE Atualização de um cluster do GKE.
GKE_NODE_POOL_UPDATE Atualização de um pool de nós do GKE.
GKE_CLUSTER_AUTOSCALER Evento do escalonador automático de cluster do GKE.
GKE_POD_AUTOSCALER Evento do escalonador automático de pods do GKE.
VM_TERMINATION Encerramento de uma máquina virtual.
VM_GUEST_OS_ERROR Erro de SO convidado em uma máquina virtual.
VM_START_FAILED Falha ao iniciar uma máquina virtual.
MIG_UPDATE Atualização de um grupo gerenciado de instâncias.
MIG_AUTOSCALER Evento de escalonamento automático para um grupo gerenciado de instâncias.
CLOUD_RUN_DEPLOYMENT Nova implantação de um serviço do Cloud Run.
CLOUD_SQL_FAILOVER Failover de uma instância do Cloud SQL.
CLOUD_SQL_START_STOP Início/interrupção de uma instância do Cloud SQL.
CLOUD_SQL_STORAGE Evento de armazenamento para uma instância do Cloud SQL.
UPTIME_CHECK_FAILURE Falha em uma verificação de tempo de atividade do Cloud Monitoring.
CLOUD_ALERTING_ALERT Alertas do Cloud Alerting
SERVICE_HEALTH_INCIDENT Incidentes do Service Health
SAP_BACKINT Eventos relacionados ao Backint do agente para SAP.
SAP_AVAILABILITY Eventos relacionados à disponibilidade do agente para SAP.
SAP_OPERATIONS Eventos relacionados às operações do agente para SAP.
INTERCONNECT_MAINTENANCE_STARTED Evento de início da manutenção da interconexão.
INTERCONNECT_MAINTENANCE_COMPLETED Evento de manutenção da interconexão concluída.
VPN_TRAFFIC_SELECTOR_NARROWING Evento de restrição do seletor de tráfego de VPN.
VPN_MAINTENANCE Evento de manutenção da VPN.

Anotações de ferramentas

As anotações de ferramentas são enviadas aos clientes do MCP para descrever o risco básico de uma determinada ferramenta. A maioria dos clientes trata essas dicas como não confiáveis, mas elas podem ser usadas para decidir quando um pedido de confirmação pode ser enviado a um usuário.

Além da string de título, as seguintes dicas booleanas são definidas da seguinte maneira:

  • readOnlyHint: se for "true", a ferramenta não vai modificar o ambiente. Padrão: false.
  • destructiveHint: se for "true", a ferramenta poderá realizar ações destrutivas. Se for "false", a ferramenta só poderá realizar ações de adição. Padrão: verdadeiro.
  • idempotentHint: se for "true", chamar a ferramenta repetidamente com os mesmos argumentos não terá efeito adicional no ambiente dela. Padrão: false.
  • openWorldHint: se for "true", a ferramenta poderá interagir com um "mundo aberto" de entidades externas. Se for "false", a ferramenta só poderá interagir com entidades internas. Por exemplo, uma ferramenta de pesquisa na Web seria de mundo aberto, enquanto uma ferramenta de memória não seria.

Dica destrutiva: ❌ | Dica idempotente: ✅ | Dica somente leitura: ✅ | Dica de mundo aberto: ❌