列出運作時間檢查伺服器 IP 位址

本文說明如何取得運作時間檢查伺服器使用的 IP 位址清單，以及如何在記錄中識別運作時間檢查伺服器的流量。

列出 IP 位址

檢查防火牆後方的服務時，您可以將服務的防火牆設為接受來自目前運作時間檢查所用 IP 位址的流量。如要取得這些 IP 位址，請按照下列操作說明進行：

控制台

  1. 前往 Google Cloud 控制台的「運作時間檢查」頁面：

    前往「Uptime checks」(運作時間檢查)

    如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。

  2. 在 Google Cloud 控制台的工具列中，選取您的 Google Cloud 專案。如為「App Hub」設定，請選取 App Hub 主機專案或已啟用應用程式的資料夾管理專案。
  3. 在「運作時間檢查」選單中，按一下 「下載」。 系統會下載 uptime-source-ips.txt 檔案，內含 IP 位址。

gcloud

執行 gcloud monitoring uptime list-ips 指令：

gcloud monitoring uptime list-ips

這個方法會傳回每個 IP 位址的下列資訊：

  • IPv4 或 IPv6 格式的 IP 位址，非範圍。
  • 地區：USA、EUROPE、SOUTH_AMERICA 或 ASIA_PACIFIC。
  • 區域內的位置。

API

呼叫 Monitoring API 的 uptimeCheckIps.list 方法。

這個方法會傳回每個 IP 位址的下列資訊：

  • 地區：USA、EUROPE、SOUTH_AMERICA 或 ASIA_PACIFIC。
  • 地區內更為具體的位置。
  • 以 IPv4 或 IPv6 格式輸入 IP 位址，而非範圍。

C#

如要驗證 Monitoring，請設定應用程式預設憑證。 詳情請參閱「為本機開發環境設定驗證」。

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

如要驗證 Monitoring，請設定應用程式預設憑證。 詳情請參閱「為本機開發環境設定驗證」。

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

如要驗證 Monitoring，請設定應用程式預設憑證。 詳情請參閱「為本機開發環境設定驗證」。


// 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: %w", 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: %w", err)
		}
		fmt.Fprintln(w, config)
	}
	fmt.Fprintln(w, "Done listing uptime check IPs")
	return nil
}

Node.js

如要驗證 Monitoring，請設定應用程式預設憑證。 詳情請參閱「為本機開發環境設定驗證」。

// 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

如要驗證 Monitoring，請設定應用程式預設憑證。 詳情請參閱「為本機開發環境設定驗證」。

use Google\Cloud\Monitoring\V3\Client\UptimeCheckServiceClient;
use Google\Cloud\Monitoring\V3\ListUptimeCheckIpsRequest;

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

    $pages = $uptimeCheckClient->listUptimeCheckIps($listUptimeCheckIpsRequest);

    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

如要驗證 Monitoring，請設定應用程式預設憑證。 詳情請參閱「為本機開發環境設定驗證」。

def list_uptime_check_ips() -> pagers.ListUptimeCheckIpsPager:
    """Gets all locations and IP addresses used by uptime check servers

    Returns:
        A list of locations and IP addresses of uptime check servers.
        Iterating over this object will yield results and resolve additional pages automatically.
    """
    client = monitoring_v3.UptimeCheckServiceClient()
    ips = client.list_uptime_check_ips(request={})
    print(
        tabulate.tabulate(
            [(ip.region, ip.location, ip.ip_address) for ip in ips],
            ("region", "location", "ip_address"),
        )
    )
    return ips

Ruby

如要驗證 Monitoring，請設定應用程式預設憑證。 詳情請參閱「為本機開發環境設定驗證」。

gem "google-cloud-monitoring"
require "google/cloud/monitoring"

def list_ips
  client = Google::Cloud::Monitoring.uptime_check_service

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

運作時間檢查可能來自任何 IP 位址，但每個時間間隔只會使用每個地理位置的一個位址。地理位置會列在運作時間檢查資訊主頁中，如上一節所示。您也可以使用免費的網頁式服務，識別您下載的 IP 位址註冊於哪些位置。

在記錄中找出運作時間檢查流量

您可以透過服務要求記錄中的下列資訊，識別來自運作時間檢查伺服器的要求：

  • ip：ip 欄位包含運作時間檢查伺服器使用的其中一個位址。如要瞭解如何列出所有 IP 位址，請參閱「列出 IP 位址」。

  • User-Agent：User-Agent 標頭值一律如下：

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

    指定 User-Agent 自訂標頭會產生表單驗證錯誤，並會讓檢查設定無法儲存。

後續步驟