This page shows you how to do the following:
- List all of your uptime checks.
- Get a list of IP addresses used by uptime checks.
To create, update, and delete your uptime checks, see Managing uptime checks page. To view pricing and limits on uptime checks, see Pricing and limits.
Listing uptime checks
Console
To list your current uptime checks, do the following:
In the Cloud Console, select Monitoring:
Select Uptime checks.
To view the details of an uptime check, click on its name.
To restrict the uptime checks that are listed, add filters.
Each filter is composed of a name and a value.
You can set the value to be an exact match for an uptime check name,
or a partial match. Matches aren't case sensitive. For example, to list all
uptime checks whose name contains default
, do the following:
- Click Filter table and select Display name.
- Enter
default
and then press the return key.
If you have multiple filters, then the filters are automatically joined
by a logical AND
unless you insert an OR
filter.
In the following example,the OR
filter is used so that an uptime check is
listed if its name matches default
or testing check
:
API
To get a list of your uptime configurations, call the
projects.uptimeCheckConfigs.list
method. Specify the following parameters:
parent: The project whose uptime checks you want to list. The format is:
projects/[PROJECT_ID]
To get a specific uptime check, call the
projects.uptimeCheckConfigs.get
method. Specify the following parameter:
name: The full name of the uptime check configuration.
projects/[PROJECT_ID]/uptimeCheckConfigs/[UPTIME_CHECK_ID]
You can get the [UPTIME_CHECK_ID] from the response of a
create
orlist
method. The ID isn't shown in the Google Cloud Console.
C#
Java
Go
Node.js
PHP
Python
Ruby
Getting uptime-check IP addresses
If you're checking a service that is behind a firewall, you can configure your service's firewall to accept traffic from the current set of IP addresses used for uptime checking. To get the IP addresses, use the following instructions:
Console
In the Cloud Console, select Monitoring:
Select Uptime checks.
In the Uptime checks menu, click Download get_app. A file
uptime-source-ips.txt
is downloaded and contains the IP addresses.
API
Call the
uptimeCheckIps.list
method of the Monitoring API.The method returns the following information for each IP address:
- The region:
USA
,EUROPE
,SOUTH_AMERICA
, orASIA_PACIFIC
. - A more specific location within the region.
- The IP address, not a range, in IPv4 or IPv6 format.
- The region:
C#
Java
Go
Node.js
PHP
Python
Ruby
Uptime checks can come from any of the IP addresses, but only one address from each geographic location is used for each time interval. The geographic locations are listed in the uptime checks dashboard, as shown in the previous section. You can also use free, web-based services to identify the registered locations of the IP addresses you downloaded.
The IP addresses used by uptime checking might change, but typically not more than once per quarter and not without an announcement.
Identifying uptime-check traffic
You can identify requests from the uptime-check servers by the following information in your service's request logs:
- ip: The
ip
field contains one of the addresses used by the uptime-check servers. See Getting IP addresses. User-Agent: The
User-Agent
header value is always the following:GoogleStackdriverMonitoring-UptimeChecks(https://cloud.google.com/monitoring)
Specifying a
User-Agent
custom header results in a form validation error and prevents the check configuration from being saved.