Reference documentation and code samples for the Compute V1 Client class BackendServiceLogConfig.
The available logging options for the load balancer traffic served by this backend service.
Generated from protobuf message google.cloud.compute.v1.BackendServiceLogConfig
Namespace
Google \ Cloud \ Compute \ V1
Methods
__construct
Constructor.
Parameters
Name
Description
data
array
Optional. Data for populating the Message object.
↳ enable
bool
Denotes whether to enable logging for the load balancer traffic served by this backend service. The default value is false.
↳ optional_fields
array
This field can only be specified if logging is enabled for this backend service and "logConfig.optionalMode" was set to CUSTOM. Contains a list of optional fields you want to include in the logs. For example: serverInstance, serverGkeDetails.cluster, serverGkeDetails.pod.podNamespace
↳ optional_mode
string
This field can only be specified if logging is enabled for this backend service. Configures whether all, none or a subset of optional fields should be added to the reported logs. One of [INCLUDE_ALL_OPTIONAL, EXCLUDE_ALL_OPTIONAL, CUSTOM]. Default is EXCLUDE_ALL_OPTIONAL. Check the OptionalMode enum for the list of possible values.
↳ sample_rate
float
This field can only be specified if logging is enabled for this backend service. The value of the field must be in [0, 1]. This configures the sampling rate of requests to the load balancer where 1.0 means all logged requests are reported and 0.0 means no logged requests are reported. The default value is 1.0.
getEnable
Denotes whether to enable logging for the load balancer traffic served by this backend service. The default value is false.
Returns
Type
Description
bool
hasEnable
clearEnable
setEnable
Denotes whether to enable logging for the load balancer traffic served by this backend service. The default value is false.
Parameter
Name
Description
var
bool
Returns
Type
Description
$this
getOptionalFields
This field can only be specified if logging is enabled for this backend service and "logConfig.optionalMode" was set to CUSTOM. Contains a list of optional fields you want to include in the logs. For example: serverInstance, serverGkeDetails.cluster, serverGkeDetails.pod.podNamespace
This field can only be specified if logging is enabled for this backend service and "logConfig.optionalMode" was set to CUSTOM. Contains a list of optional fields you want to include in the logs. For example: serverInstance, serverGkeDetails.cluster, serverGkeDetails.pod.podNamespace
Parameter
Name
Description
var
string[]
Returns
Type
Description
$this
getOptionalMode
This field can only be specified if logging is enabled for this backend service. Configures whether all, none or a subset of optional fields should be added to the reported logs. One of [INCLUDE_ALL_OPTIONAL, EXCLUDE_ALL_OPTIONAL, CUSTOM]. Default is EXCLUDE_ALL_OPTIONAL.
Check the OptionalMode enum for the list of possible values.
Returns
Type
Description
string
hasOptionalMode
clearOptionalMode
setOptionalMode
This field can only be specified if logging is enabled for this backend service. Configures whether all, none or a subset of optional fields should be added to the reported logs. One of [INCLUDE_ALL_OPTIONAL, EXCLUDE_ALL_OPTIONAL, CUSTOM]. Default is EXCLUDE_ALL_OPTIONAL.
Check the OptionalMode enum for the list of possible values.
Parameter
Name
Description
var
string
Returns
Type
Description
$this
getSampleRate
This field can only be specified if logging is enabled for this backend service. The value of the field must be in [0, 1]. This configures the sampling rate of requests to the load balancer where 1.0 means all logged requests are reported and 0.0 means no logged requests are reported. The default value is 1.0.
Returns
Type
Description
float
hasSampleRate
clearSampleRate
setSampleRate
This field can only be specified if logging is enabled for this backend service. The value of the field must be in [0, 1]. This configures the sampling rate of requests to the load balancer where 1.0 means all logged requests are reported and 0.0 means no logged requests are reported. The default value is 1.0.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["# Compute V1 Client - Class BackendServiceLogConfig (1.35.0)\n\nVersion latestkeyboard_arrow_down\n\n- [1.35.0 (latest)](/php/docs/reference/cloud-compute/latest/V1.BackendServiceLogConfig)\n- [1.34.0](/php/docs/reference/cloud-compute/1.34.0/V1.BackendServiceLogConfig)\n- [1.33.0](/php/docs/reference/cloud-compute/1.33.0/V1.BackendServiceLogConfig)\n- [1.32.0](/php/docs/reference/cloud-compute/1.32.0/V1.BackendServiceLogConfig)\n- [1.31.0](/php/docs/reference/cloud-compute/1.31.0/V1.BackendServiceLogConfig)\n- [1.30.0](/php/docs/reference/cloud-compute/1.30.0/V1.BackendServiceLogConfig)\n- [1.29.0](/php/docs/reference/cloud-compute/1.29.0/V1.BackendServiceLogConfig)\n- [1.28.0](/php/docs/reference/cloud-compute/1.28.0/V1.BackendServiceLogConfig)\n- [1.27.0](/php/docs/reference/cloud-compute/1.27.0/V1.BackendServiceLogConfig)\n- [1.26.0](/php/docs/reference/cloud-compute/1.26.0/V1.BackendServiceLogConfig)\n- [1.25.0](/php/docs/reference/cloud-compute/1.25.0/V1.BackendServiceLogConfig)\n- [1.24.0](/php/docs/reference/cloud-compute/1.24.0/V1.BackendServiceLogConfig)\n- [1.23.0](/php/docs/reference/cloud-compute/1.23.0/V1.BackendServiceLogConfig)\n- [1.22.1](/php/docs/reference/cloud-compute/1.22.1/V1.BackendServiceLogConfig)\n- [1.21.0](/php/docs/reference/cloud-compute/1.21.0/V1.BackendServiceLogConfig)\n- [1.20.0](/php/docs/reference/cloud-compute/1.20.0/V1.BackendServiceLogConfig)\n- [1.19.0](/php/docs/reference/cloud-compute/1.19.0/V1.BackendServiceLogConfig)\n- [1.18.1](/php/docs/reference/cloud-compute/1.18.1/V1.BackendServiceLogConfig)\n- [1.17.0](/php/docs/reference/cloud-compute/1.17.0/V1.BackendServiceLogConfig)\n- [1.16.2](/php/docs/reference/cloud-compute/1.16.2/V1.BackendServiceLogConfig)\n- [1.14.0](/php/docs/reference/cloud-compute/1.14.0/V1.BackendServiceLogConfig)\n- [1.13.0](/php/docs/reference/cloud-compute/1.13.0/V1.BackendServiceLogConfig)\n- [1.12.1](/php/docs/reference/cloud-compute/1.12.1/V1.BackendServiceLogConfig)\n- [1.11.1](/php/docs/reference/cloud-compute/1.11.1/V1.BackendServiceLogConfig)\n- [1.10.1](/php/docs/reference/cloud-compute/1.10.1/V1.BackendServiceLogConfig)\n- [1.9.1](/php/docs/reference/cloud-compute/1.9.1/V1.BackendServiceLogConfig)\n- [1.8.3](/php/docs/reference/cloud-compute/1.8.3/V1.BackendServiceLogConfig)\n- [1.7.1](/php/docs/reference/cloud-compute/1.7.1/V1.BackendServiceLogConfig)\n- [1.6.1](/php/docs/reference/cloud-compute/1.6.1/V1.BackendServiceLogConfig)\n- [1.5.0](/php/docs/reference/cloud-compute/1.5.0/V1.BackendServiceLogConfig) \nReference documentation and code samples for the Compute V1 Client class BackendServiceLogConfig.\n\nThe available logging options for the load balancer traffic served by this backend service.\n\nGenerated from protobuf message `google.cloud.compute.v1.BackendServiceLogConfig`\n\nNamespace\n---------\n\nGoogle \\\\ Cloud \\\\ Compute \\\\ V1\n\nMethods\n-------\n\n### __construct\n\nConstructor.\n\n### getEnable\n\nDenotes whether to enable logging for the load balancer traffic served by this backend service. The default value is false.\n\n### hasEnable\n\n### clearEnable\n\n### setEnable\n\nDenotes whether to enable logging for the load balancer traffic served by this backend service. The default value is false.\n\n### getOptionalFields\n\nThis field can only be specified if logging is enabled for this backend service and \"logConfig.optionalMode\" was set to CUSTOM. Contains a list of optional fields you want to include in the logs. For example: serverInstance, serverGkeDetails.cluster, serverGkeDetails.pod.podNamespace\n\n### setOptionalFields\n\nThis field can only be specified if logging is enabled for this backend service and \"logConfig.optionalMode\" was set to CUSTOM. Contains a list of optional fields you want to include in the logs. For example: serverInstance, serverGkeDetails.cluster, serverGkeDetails.pod.podNamespace\n\n### getOptionalMode\n\nThis field can only be specified if logging is enabled for this backend service. Configures whether all, none or a subset of optional fields should be added to the reported logs. One of \\[INCLUDE_ALL_OPTIONAL, EXCLUDE_ALL_OPTIONAL, CUSTOM\\]. Default is EXCLUDE_ALL_OPTIONAL.\n\nCheck the OptionalMode enum for the list of possible values.\n\n### hasOptionalMode\n\n### clearOptionalMode\n\n### setOptionalMode\n\nThis field can only be specified if logging is enabled for this backend service. Configures whether all, none or a subset of optional fields should be added to the reported logs. One of \\[INCLUDE_ALL_OPTIONAL, EXCLUDE_ALL_OPTIONAL, CUSTOM\\]. Default is EXCLUDE_ALL_OPTIONAL.\n\nCheck the OptionalMode enum for the list of possible values.\n\n### getSampleRate\n\nThis field can only be specified if logging is enabled for this backend service. The value of the field must be in \\[0, 1\\]. This configures the sampling rate of requests to the load balancer where 1.0 means all logged requests are reported and 0.0 means no logged requests are reported. The default value is 1.0.\n\n### hasSampleRate\n\n### clearSampleRate\n\n### setSampleRate\n\nThis field can only be specified if logging is enabled for this backend service. The value of the field must be in \\[0, 1\\]. This configures the sampling rate of requests to the load balancer where 1.0 means all logged requests are reported and 0.0 means no logged requests are reported. The default value is 1.0."]]