Skip to main content


6.2.5 Set 'Log_hostname' Database Flag for Cloud SQL PostgreSQL Instance to 'on' (Automated)

Profile Applicability

• Level 1


PostgreSQL logs only the IP address of the connecting hosts. The log_hostname flag controls the logging of hostnames in addition to the IP addresses logged. The performance hit is dependent on the configuration of the environment and the host name resolution setup. It is only possible to set this parameter in the postgresql.conf file or on the server command line.


Logging hostnames allows for the association of hostname to IP address at the time of connection. This information can aid with incident response efforts particularly in an environment that utilized dynamic IP addresses. Logging hostnames may incur overhead on server performance as for each statement logged, DNS resolution will be required to convert IP address to hostname. Depending on the setup, this may be non-negligible. This recommendation is applicable to PostgreSQL database instances.


Setting custom flags via command line on certain instances will cause all omitted flags to be reset to defaults. This may cause you to lose custom flags and could result in unforeseen complications or instance restarts. Because of this, it is recommended you apply these flags changes during a period of low usage.


From Console:

  1. Go to the Cloud SQL Instances page in the Google Cloud Console by visiting
  2. Select the instance to open its Instance Overview page
  3. Go to Configuration card
  4. Under Database flags, check the value of log_hostname flag is set to 'On'.

From Command Line:

  1. Use the below command for every Cloud SQL PostgreSQL database instance to verify the value of log_hostname
gcloud sql instances list --format=json | jq '.settings.databaseFlags[] | select(.name=="log_hostname")|.value'


From Console:

  1. Go to the Cloud SQL Instances page in the Google Cloud Console by visiting:
  2. Select the PostgreSQL instance for which you want to enable the database flag.
  3. Click Edit.
  4. Scroll down to the Flags section.
  5. To set a flag that is new to the instance, click Add item, choose the flag log_hostname from the drop-down menu and the value to On.
  6. Click Save to save your changes.
  7. Confirm your changes under Flags on the Overview page.

From Command Line:

  1. Configure the log_hostname database flag for every Cloud SQL PosgreSQL database instance using the below command.
gcloud sql instances patch <instance_name> --database-flags log_hostname=on

This command overwrites all database flags previously set. To keep those and add new ones, include the values for all flags you want set on the instance; any flag not specifically included uses the default value. For flags that do not take a value, specify the flag name followed by an equals sign ("=").


Additional Information


This patch modifies database flag values, which may require you to restart your instance. The list of supported flags is on this page, along with details of which flags require a restart:


Some database flag settings can affect instance availability or stability and remove the instance from the Cloud SQL Service-Level Agreement (SLA). For information about these flags, see Operational Guidelines.


Configuring the preceding flag does not require restarting the Cloud SQL instance.