Como avaliar verificações de tempo de atividade

Nesta página, são exibidos os seguintes processos relacionados às verificações de tempo de atividade:

  • Analisar o status das suas verificações de tempo de atividade.
  • Ver uma lista de endereços IP usados pelas verificações de tempo de atividade.

Para criar, atualizar e excluir as verificações de tempo de atividade, consulte a página Como gerenciar verificações de tempo de atividade. Você pode ter até 100 verificações de tempo de atividade por espaço de trabalho.

Visão geral da verificação de tempo de atividade

O Monitoring tem uma página de visão geral que mostra todas as verificações de tempo de atividade e painéis detalhados de verificações individuais.

Para vê-la, acesse Verificações de tempo de atividade > Visão geral das verificações de tempo de atividade:

Acessar "Visão geral das verificações de tempo de atividade"

Para cada verificação de tempo de atividade, é possível ver o último resultado de verificação de cada local, conforme mostrado na seguinte captura de tela:

Monitor de verificações de tempo de atividade

Painéis

Para ver o status detalhado de uma única verificação de tempo de atividade, clique em qualquer uma delas na visão geral ou na lista do menu Verificações de tempo de atividade na navegação do lado esquerdo. Veja a seguir um painel de exemplo:

Detalhes da verificação de tempo de atividade

A região Resultados do local mostra os resultados da verificação de tempo de atividade em todas as regiões aplicáveis. Um ponto verde ao lado de uma região indica que a última execução da verificação nessa região foi concluída. Já um ponto vermelho indica falha. Ao mover o mouse sobre o ponto, a latência da última execução é exibida, bem como o código de resposta HTTP, se aplicável.

A região Configuração da verificação apresenta uma descrição da verificação de tempo de atividade, que inclui o Código de verificação. Esse código é atribuído quando a verificação é criada. O valor corresponde ao [UPTIME_CHECK_ID] nas chamadas de API.

API

Para recuperar as configurações de verificação de tempo de atividade atuais, use projects.uptimeCheckConfigs.list.

Na API, as verificações de tempo de atividade são identificadas pelo [UPTIME_CHECK_ID], que é uma repetição do nome da verificação de tempo de atividade. Por exemplo, o nome de verificação "my uptime check" pode se tornar o código "my-uptime-check" ou o mapeamento pode ser mais complicado.

Você atribui o nome que visualiza na Visão geral de tempo de atividade no console do Stackdriver Monitoring.

Porcentagem de tempo de atividade

O valor do tempo de atividade é uma porcentagem calculada como (S/T)*100, em que S é o número de respostas de verificação bem-sucedidas e T é o número total de respostas de verificação de todos os locais.

Para verificações de grupo, os valores de S e T são somados em todos os membros atuais do grupo.

Por exemplo, durante um período de 25 minutos, uma verificação de tempo de atividade com um período de 1 minuto sendo executada de todas as regiões receberia 25 solicitações de cada um dos 6 locais, para um total de 150 solicitações. Se o painel reporta um tempo de atividade de 83,3%, isso significa que 25 das 150 solicitações falharam.

Ver os endereços IP da verificação de tempo de atividade

Se o serviço em verificação está protegido por um firewall, é possível configurar esse firewall para aceitar tráfego proveniente do conjunto atual de endereços IP utilizado na verificação de tempo de atividade. Para ver os endereços IP, siga as seguintes instruções:

Console

1. Acesse a página Verificações de tempo de atividade do projeto.

  1. No menu Mais ao lado de Adicionar verificação de tempo de atividade, selecione Fazer o download de IPs de origem:

    IPs de download da verificação de tempo de atividade

API

  1. Chame o método uptimeCheckIps.list da API Monitoring.

  2. O método retorna as informações a seguir sobre cada endereço IP:

    • a região: USA, EUROPE, SOUTH_AMERICA ou ASIA_PACIFIC;
    • uma localização mais específica dentro da região;
    • o endereço IP, não um intervalo, nos formatos IPv4 ou IPv6.

C#

public static object ListUptimeCheckIps()
{
    var client = UptimeCheckServiceClient.Create();
    var ips = client.ListUptimeCheckIps(new ListUptimeCheckIpsRequest());
    foreach (UptimeCheckIp ip in ips)
    {
        Console.WriteLine("{0,20} {1}", ip.IpAddress, ip.Location);
    }
    return 0;
}

Java

private static void listUptimeCheckIPs() throws IOException {
  try (UptimeCheckServiceClient client = UptimeCheckServiceClient.create()) {
    ListUptimeCheckIpsPagedResponse response =
        client.listUptimeCheckIps(ListUptimeCheckIpsRequest.newBuilder().build());
    for (UptimeCheckIp config : response.iterateAll()) {
      System.out.println(config.getRegion() + " - " + config.getIpAddress());
    }
  } catch (Exception e) {
    usage("Exception listing uptime IPs: " + e.toString());
    throw e;
  }
}

Go

// listIPs is an example of listing uptime check IPs.
func listIPs(w io.Writer) error {
	ctx := context.Background()
	client, err := monitoring.NewUptimeCheckClient(ctx)
	if err != nil {
		return fmt.Errorf("NewUptimeCheckClient: %v", err)
	}
	defer client.Close()
	req := &monitoringpb.ListUptimeCheckIpsRequest{}
	it := client.ListUptimeCheckIps(ctx, req)
	for {
		config, err := it.Next()
		if err == iterator.Done {
			break
		}
		if err != nil {
			return fmt.Errorf("ListUptimeCheckIps: %v", err)
		}
		fmt.Fprintln(w, config)
	}
	fmt.Fprintln(w, "Done listing uptime check IPs")
	return nil
}

Node.js

// Imports the Google Cloud client library
const monitoring = require('@google-cloud/monitoring');

// Creates a client
const client = new monitoring.UptimeCheckServiceClient();

// List uptime check IPs
const [uptimeCheckIps] = await client.listUptimeCheckIps();
uptimeCheckIps.forEach(uptimeCheckIp => {
  console.log(
    uptimeCheckIp.region,
    uptimeCheckIp.location,
    uptimeCheckIp.ipAddress
  );
});

PHP

use Google\Cloud\Monitoring\V3\UptimeCheckServiceClient;

/**
 * Example:
 * ```
 * list_uptime_check_ips($projectId);
 * ```
 */
function list_uptime_check_ips($projectId)
{
    $uptimeCheckClient = new UptimeCheckServiceClient([
        'projectId' => $projectId,
    ]);

    $pages = $uptimeCheckClient->listUptimeCheckIps();

    foreach ($pages->iteratePages() as $page) {
        $ips = $page->getResponseObject()->getUptimeCheckIps();
        foreach ($ips as $ip) {
            printf(
                'ip address: %s, region: %s, location: %s' . PHP_EOL,
                $ip->getIpAddress(),
                $ip->getRegion(),
                $ip->getLocation()
            );
        }
    }
}

Python

def list_uptime_check_ips():
    client = monitoring_v3.UptimeCheckServiceClient()
    ips = client.list_uptime_check_ips()
    print(tabulate.tabulate(
        [(ip.region, ip.location, ip.ip_address) for ip in ips],
        ('region', 'location', 'ip_address')
    ))

Ruby

def list_ips
  require "google/cloud/monitoring/v3"
  client = Google::Cloud::Monitoring::V3::UptimeCheck.new

  # Iterate over all results.
  client.list_uptime_check_ips.each do |element|
    puts "#{element.location} #{element.ip_address}"
  end
end

As informações retornadas normalmente contêm cerca de 20 endereços IP. As verificações de tempo de atividade podem vir de qualquer um dos endereços IP, mas apenas um endereço de cada localização geográfica é usado para cada período. As localizações geográficas são listadas no painel de verificações de tempo de atividade mostrado na seção anterior. Também é possível usar serviços gratuitos baseados na Web para identificar as localizações registradas dos endereços IP recebidos por download.

Os endereços IP usados pela verificação de tempo de atividade podem mudar. Normalmente, isso ocorre no máximo uma vez por trimestre, com um anúncio.

Identificar o tráfego da verificação de tempo de atividade

É possível identificar solicitações dos servidores de verificação de tempo de atividade de acordo com as informações contidas nos registros de solicitações do serviço:

  • ip: o campo ip contém um dos endereços usados pelos servidores de verificação de tempo de atividade. Consulte Como receber endereços IP.
  • User-Agent: o valor do cabeçalho User-Agent é sempre este:

    GoogleStackdriverMonitoring-UptimeChecks(https://cloud.google.com/monitoring)
    

    A especificação de um cabeçalho User-Agent personalizado gera um erro de validação de formulário e impede que a configuração da verificação seja salva.

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Stackdriver Monitoring
Precisa de ajuda? Acesse nossa página de suporte.