google-cloud-logging 1.5.4 → 1.5.5

data/lib/google/cloud/logging/v2/doc/google/api/metric.rb

@@ -24,73 +24,74 @@ module Google
     # @!attribute [rw] type
     #   @return [String]
     #     The metric type, including its DNS name prefix. The type is not
-    #     URL-encoded.  All user-defined custom metric types have the DNS name
-    #     +custom.googleapis.com+.  Metric types should use a natural hierarchical
-    #     grouping. For example:
+    #     URL-encoded.  All user-defined metric types have the DNS name
+    #     `custom.googleapis.com` or `external.googleapis.com`.  Metric types should
+    #     use a natural hierarchical grouping. For example:
     #
     #         "custom.googleapis.com/invoice/paid/amount"
+    #         "external.googleapis.com/prometheus/up"
     #         "appengine.googleapis.com/http/server/response_latencies"
     # @!attribute [rw] labels
     #   @return [Array<Google::Api::LabelDescriptor>]
     #     The set of labels that can be used to describe a specific
     #     instance of this metric type. For example, the
-    #     +appengine.googleapis.com/http/server/response_latencies+ metric
-    #     type has a label for the HTTP response code, +response_code+, so
+    #     `appengine.googleapis.com/http/server/response_latencies` metric
+    #     type has a label for the HTTP response code, `response_code`, so
     #     you can look at latencies for successful responses or just
     #     for responses that failed.
     # @!attribute [rw] metric_kind
     #   @return [Google::Api::MetricDescriptor::MetricKind]
     #     Whether the metric records instantaneous values, changes to a value, etc.
-    #     Some combinations of +metric_kind+ and +value_type+ might not be supported.
+    #     Some combinations of `metric_kind` and `value_type` might not be supported.
     # @!attribute [rw] value_type
     #   @return [Google::Api::MetricDescriptor::ValueType]
     #     Whether the measurement is an integer, a floating-point number, etc.
-    #     Some combinations of +metric_kind+ and +value_type+ might not be supported.
+    #     Some combinations of `metric_kind` and `value_type` might not be supported.
     # @!attribute [rw] unit
     #   @return [String]
     #     The unit in which the metric value is reported. It is only applicable
-    #     if the +value_type+ is +INT64+, +DOUBLE+, or +DISTRIBUTION+. The
+    #     if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The
     #     supported units are a subset of [The Unified Code for Units of
     #     Measure](http://unitsofmeasure.org/ucum.html) standard:
     #
     #     **Basic units (UNIT)**
     #
-    #     * +bit+   bit
-    #     * +By+    byte
-    #     * +s+     second
-    #     * +min+   minute
-    #     * +h+     hour
-    #     * +d+     day
+    #     * `bit`   bit
+    #     * `By`    byte
+    #     * `s`     second
+    #     * `min`   minute
+    #     * `h`     hour
+    #     * `d`     day
     #
     #     **Prefixes (PREFIX)**
     #
-    #     * +k+     kilo    (10**3)
-    #     * +M+     mega    (10**6)
-    #     * +G+     giga    (10**9)
-    #     * +T+     tera    (10**12)
-    #     * +P+     peta    (10**15)
-    #     * +E+     exa     (10**18)
-    #     * +Z+     zetta   (10**21)
-    #     * +Y+     yotta   (10**24)
-    #     * +m+     milli   (10**-3)
-    #     * +u+     micro   (10**-6)
-    #     * +n+     nano    (10**-9)
-    #     * +p+     pico    (10**-12)
-    #     * +f+     femto   (10**-15)
-    #     * +a+     atto    (10**-18)
-    #     * +z+     zepto   (10**-21)
-    #     * +y+     yocto   (10**-24)
-    #     * +Ki+    kibi    (2**10)
-    #     * +Mi+    mebi    (2**20)
-    #     * +Gi+    gibi    (2**30)
-    #     * +Ti+    tebi    (2**40)
+    #     * `k`     kilo    (10**3)
+    #     * `M`     mega    (10**6)
+    #     * `G`     giga    (10**9)
+    #     * `T`     tera    (10**12)
+    #     * `P`     peta    (10**15)
+    #     * `E`     exa     (10**18)
+    #     * `Z`     zetta   (10**21)
+    #     * `Y`     yotta   (10**24)
+    #     * `m`     milli   (10**-3)
+    #     * `u`     micro   (10**-6)
+    #     * `n`     nano    (10**-9)
+    #     * `p`     pico    (10**-12)
+    #     * `f`     femto   (10**-15)
+    #     * `a`     atto    (10**-18)
+    #     * `z`     zepto   (10**-21)
+    #     * `y`     yocto   (10**-24)
+    #     * `Ki`    kibi    (2**10)
+    #     * `Mi`    mebi    (2**20)
+    #     * `Gi`    gibi    (2**30)
+    #     * `Ti`    tebi    (2**40)
     #
     #     **Grammar**
     #
     #     The grammar also includes these connectors:
     #
-    #     * +/+    division (as an infix operator, e.g. +1/s+).
-    #     * +.+    multiplication (as an infix operator, e.g. +GBy.d+)
+    #     * `/`    division (as an infix operator, e.g. `1/s`).
+    #     * `.`    multiplication (as an infix operator, e.g. `GBy.d`)
     #
     #     The grammar for a unit is as follows:
     #
@@ -105,13 +106,13 @@ module Google
     #
     #     Notes:
     #
-    #     * +Annotation+ is just a comment if it follows a +UNIT+ and is
-    #       equivalent to +1+ if it is used alone. For examples,
-    #       +\\{requests}/s == 1/s+, +By\\{transmitted}/s == By/s+.
-    #     * +NAME+ is a sequence of non-blank printable ASCII characters not
+    #     * `Annotation` is just a comment if it follows a `UNIT` and is
+    #       equivalent to `1` if it is used alone. For examples,
+    #       `{requests}/s == 1/s`, `By{transmitted}/s == By/s`.
+    #     * `NAME` is a sequence of non-blank printable ASCII characters not
     #       containing '{' or '}'.
-    #     * +1+ represents dimensionless value 1, such as in +1/s+.
-    #     * +%+ represents dimensionless value 1/100, and annotates values giving
+    #     * `1` represents dimensionless value 1, such as in `1/s`.
+    #     * `%` represents dimensionless value 1/100, and annotates values giving
     #       a percentage.
     # @!attribute [rw] description
     #   @return [String]
@@ -122,7 +123,27 @@ module Google
     #     Use sentence case without an ending period, for example "Request count".
     #     This field is optional but it is recommended to be set for any metrics
     #     associated with user-visible concepts, such as Quota.
+    # @!attribute [rw] metadata
+    #   @return [Google::Api::MetricDescriptor::MetricDescriptorMetadata]
+    #     Optional. Metadata which can be used to guide usage of the metric.
     class MetricDescriptor
+      # Additional annotations that can be used to guide the usage of a metric.
+      # @!attribute [rw] launch_stage
+      #   @return [Google::Api::LaunchStage]
+      #     The launch stage of the metric definition.
+      # @!attribute [rw] sample_period
+      #   @return [Google::Protobuf::Duration]
+      #     The sampling period of metric data points. For metrics which are written
+      #     periodically, consecutive data points are stored at this time interval,
+      #     excluding data loss due to errors. Metrics with a higher granularity have
+      #     a smaller sampling period.
+      # @!attribute [rw] ingest_delay
+      #   @return [Google::Protobuf::Duration]
+      #     The delay of data points caused by ingestion. Data points older than this
+      #     age are guaranteed to be ingested and available to be read, excluding
+      #     data loss due to errors.
+      class MetricDescriptorMetadata; end
+
       # The kind of measurement. It describes how the data is reported.
       module MetricKind
         # Do not use this default value.
@@ -148,7 +169,7 @@ module Google
         VALUE_TYPE_UNSPECIFIED = 0
 
         # The value is a boolean.
-        # This value type can be used only if the metric kind is +GAUGE+.
+        # This value type can be used only if the metric kind is `GAUGE`.
         BOOL = 1
 
         # The value is a signed 64-bit integer.
@@ -158,10 +179,10 @@ module Google
         DOUBLE = 3
 
         # The value is a text string.
-        # This value type can be used only if the metric kind is +GAUGE+.
+        # This value type can be used only if the metric kind is `GAUGE`.
         STRING = 4
 
-        # The value is a {Google::Api::Distribution +Distribution+}.
+        # The value is a {Google::Api::Distribution `Distribution`}.
         DISTRIBUTION = 5
 
         # The value is money.
@@ -170,15 +191,15 @@ module Google
     end
 
     # A specific metric, identified by specifying values for all of the
-    # labels of a {Google::Api::MetricDescriptor +MetricDescriptor+}.
+    # labels of a {Google::Api::MetricDescriptor `MetricDescriptor`}.
     # @!attribute [rw] type
     #   @return [String]
     #     An existing metric type, see {Google::Api::MetricDescriptor}.
-    #     For example, +custom.googleapis.com/invoice/paid/amount+.
+    #     For example, `custom.googleapis.com/invoice/paid/amount`.
     # @!attribute [rw] labels
     #   @return [Hash{String => String}]
     #     The set of label values that uniquely identify this metric. All
-    #     labels listed in the +MetricDescriptor+ must be assigned values.
+    #     labels listed in the `MetricDescriptor` must be assigned values.
     class Metric; end
   end
 end

data/lib/google/cloud/logging/v2/doc/google/api/monitored_resource.rb

@@ -18,31 +18,31 @@ module Google
     # An object that describes the schema of a {Google::Api::MonitoredResource MonitoredResource} object using a
     # type name and a set of labels.  For example, the monitored resource
     # descriptor for Google Compute Engine VM instances has a type of
-    # +"gce_instance"+ and specifies the use of the labels +"instance_id"+ and
-    # +"zone"+ to identify particular VM instances.
+    # `"gce_instance"` and specifies the use of the labels `"instance_id"` and
+    # `"zone"` to identify particular VM instances.
     #
     # Different APIs can support different monitored resource types. APIs generally
-    # provide a +list+ method that returns the monitored resource descriptors used
+    # provide a `list` method that returns the monitored resource descriptors used
     # by the API.
     # @!attribute [rw] name
     #   @return [String]
     #     Optional. The resource name of the monitored resource descriptor:
-    #     +"projects/\\{project_id}/monitoredResourceDescriptors/\\{type}"+ where
-    #     \\{type} is the value of the +type+ field in this object and
+    #     `"projects/{project_id}/monitoredResourceDescriptors/{type}"` where
+    #     \\{type} is the value of the `type` field in this object and
     #     \\{project_id} is a project ID that provides API-specific context for
     #     accessing the type.  APIs that do not use project information can use the
-    #     resource name format +"monitoredResourceDescriptors/\\{type}"+.
+    #     resource name format `"monitoredResourceDescriptors/{type}"`.
     # @!attribute [rw] type
     #   @return [String]
     #     Required. The monitored resource type. For example, the type
-    #     +"cloudsql_database"+ represents databases in Google Cloud SQL.
+    #     `"cloudsql_database"` represents databases in Google Cloud SQL.
     #     The maximum length of this value is 256 characters.
     # @!attribute [rw] display_name
     #   @return [String]
     #     Optional. A concise name for the monitored resource type that might be
     #     displayed in user interfaces. It should be a Title Cased Noun Phrase,
     #     without any article or other determiners. For example,
-    #     +"Google Cloud SQL Database"+.
+    #     `"Google Cloud SQL Database"`.
     # @!attribute [rw] description
     #   @return [String]
     #     Optional. A detailed description of the monitored resource type that might
@@ -51,18 +51,18 @@ module Google
     #   @return [Array<Google::Api::LabelDescriptor>]
     #     Required. A set of labels used to describe instances of this monitored
     #     resource type. For example, an individual Google Cloud SQL database is
-    #     identified by values for the labels +"database_id"+ and +"zone"+.
+    #     identified by values for the labels `"database_id"` and `"zone"`.
     class MonitoredResourceDescriptor; end
 
     # An object representing a resource that can be used for monitoring, logging,
     # billing, or other purposes. Examples include virtual machine instances,
-    # databases, and storage devices such as disks. The +type+ field identifies a
+    # databases, and storage devices such as disks. The `type` field identifies a
     # {Google::Api::MonitoredResourceDescriptor MonitoredResourceDescriptor} object that describes the resource's
-    # schema. Information in the +labels+ field identifies the actual resource and
+    # schema. Information in the `labels` field identifies the actual resource and
     # its attributes according to the schema. For example, a particular Compute
     # Engine VM instance could be represented by the following object, because the
-    # {Google::Api::MonitoredResourceDescriptor MonitoredResourceDescriptor} for +"gce_instance"+ has labels
-    # +"instance_id"+ and +"zone"+:
+    # {Google::Api::MonitoredResourceDescriptor MonitoredResourceDescriptor} for `"gce_instance"` has labels
+    # `"instance_id"` and `"zone"`:
     #
     #     { "type": "gce_instance",
     #       "labels": { "instance_id": "12345678901234",
@@ -70,27 +70,26 @@ module Google
     # @!attribute [rw] type
     #   @return [String]
     #     Required. The monitored resource type. This field must match
-    #     the +type+ field of a {Google::Api::MonitoredResourceDescriptor MonitoredResourceDescriptor} object. For
-    #     example, the type of a Compute Engine VM instance is +gce_instance+.
+    #     the `type` field of a {Google::Api::MonitoredResourceDescriptor MonitoredResourceDescriptor} object. For
+    #     example, the type of a Compute Engine VM instance is `gce_instance`.
     # @!attribute [rw] labels
     #   @return [Hash{String => String}]
     #     Required. Values for all of the labels listed in the associated monitored
     #     resource descriptor. For example, Compute Engine VM instances use the
-    #     labels +"project_id"+, +"instance_id"+, and +"zone"+.
+    #     labels `"project_id"`, `"instance_id"`, and `"zone"`.
     class MonitoredResource; end
 
     # Auxiliary metadata for a {Google::Api::MonitoredResource MonitoredResource} object.
     # {Google::Api::MonitoredResource MonitoredResource} objects contain the minimum set of information to
     # uniquely identify a monitored resource instance. There is some other useful
-    # auxiliary metadata. Google Stackdriver Monitoring & Logging uses an ingestion
-    # pipeline to extract metadata for cloud resources of all types , and stores
+    # auxiliary metadata. Monitoring and Logging use an ingestion
+    # pipeline to extract metadata for cloud resources of all types, and store
     # the metadata in this message.
     # @!attribute [rw] system_labels
     #   @return [Google::Protobuf::Struct]
     #     Output only. Values for predefined system metadata labels.
-    #     System labels are a kind of metadata extracted by Google Stackdriver.
-    #     Stackdriver determines what system labels are useful and how to obtain
-    #     their values. Some examples: "machine_image", "vpc", "subnet_id",
+    #     System labels are a kind of metadata extracted by Google, including
+    #     "machine_image", "vpc", "subnet_id",
     #     "security_group", "name", etc.
     #     System label values can be only strings, Boolean values, or a list of
     #     strings. For example:

data/lib/google/cloud/logging/v2/doc/google/logging/type/http_request.rb

@@ -21,12 +21,12 @@ module Google
       # information MUST be defined in a separate message.
       # @!attribute [rw] request_method
       #   @return [String]
-      #     The request method. Examples: +"GET"+, +"HEAD"+, +"PUT"+, +"POST"+.
+      #     The request method. Examples: `"GET"`, `"HEAD"`, `"PUT"`, `"POST"`.
       # @!attribute [rw] request_url
       #   @return [String]
       #     The scheme (http, https), the host name, the path and the query
       #     portion of the URL that was requested.
-      #     Example: +"http://example.com/some/info?color=red"+.
+      #     Example: `"http://example.com/some/info?color=red"`.
       # @!attribute [rw] request_size
       #   @return [Integer]
       #     The size of the HTTP request message in bytes, including the request
@@ -42,11 +42,11 @@ module Google
       # @!attribute [rw] user_agent
       #   @return [String]
       #     The user agent sent by the client. Example:
-      #     +"Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET CLR 1.0.3705)"+.
+      #     `"Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET CLR 1.0.3705)"`.
       # @!attribute [rw] remote_ip
       #   @return [String]
       #     The IP address (IPv4 or IPv6) of the client that issued the HTTP
-      #     request. Examples: +"192.168.1.1"+, +"FE80::0202:B3FF:FE1E:8329"+.
+      #     request. Examples: `"192.168.1.1"`, `"FE80::0202:B3FF:FE1E:8329"`.
       # @!attribute [rw] server_ip
       #   @return [String]
       #     The IP address (IPv4 or IPv6) of the origin server that the request was
@@ -69,7 +69,7 @@ module Google
       # @!attribute [rw] cache_validated_with_origin_server
       #   @return [true, false]
       #     Whether or not the response was validated with the origin server before
-      #     being served from cache. This field is only meaningful if +cache_hit+ is
+      #     being served from cache. This field is only meaningful if `cache_hit` is
       #     True.
       # @!attribute [rw] cache_fill_bytes
       #   @return [Integer]

data/lib/google/cloud/logging/v2/doc/google/logging/v2/log_entry.rb

@@ -28,16 +28,16 @@ module Google
       #
       #      A project number may optionally be used in place of PROJECT_ID. The
       #      project number is translated to its corresponding PROJECT_ID internally
-      #      and the +log_name+ field will contain PROJECT_ID in queries and exports.
+      #      and the `log_name` field will contain PROJECT_ID in queries and exports.
       #
-      #     +[LOG_ID]+ must be URL-encoded within +log_name+. Example:
-      #     +"organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"+.
-      #     +[LOG_ID]+ must be less than 512 characters long and can only include the
+      #     `[LOG_ID]` must be URL-encoded within `log_name`. Example:
+      #     `"organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"`.
+      #     `[LOG_ID]` must be less than 512 characters long and can only include the
       #     following characters: upper and lower case alphanumeric characters,
       #     forward-slash, underscore, hyphen, and period.
       #
-      #     For backward compatibility, if +log_name+ begins with a forward-slash, such
-      #     as +/projects/...+, then the log entry is ingested as usual but the
+      #     For backward compatibility, if `log_name` begins with a forward-slash, such
+      #     as `/projects/...`, then the log entry is ingested as usual but the
       #     forward-slash is removed. Listing the log entry will not show the leading
       #     slash and filtering for a log name with a leading slash will never return
       #     any results.
@@ -71,7 +71,7 @@ module Google
       #     Incoming log entries should have timestamps that are no more than
       #     the [logs retention period](https://cloud.google.com/logging/quotas) in the past,
       #     and no more than 24 hours in the future. Log entries outside those time
-      #     boundaries will not be available when calling +entries.list+, but
+      #     boundaries will not be available when calling `entries.list`, but
       #     those log entries can still be exported with
       #     [LogSinks](https://cloud.google.com/logging/docs/api/tasks/exporting-logs).
       # @!attribute [rw] receive_timestamp
@@ -80,15 +80,15 @@ module Google
       # @!attribute [rw] severity
       #   @return [Google::Logging::Type::LogSeverity]
       #     Optional. The severity of the log entry. The default value is
-      #     +LogSeverity.DEFAULT+.
+      #     `LogSeverity.DEFAULT`.
       # @!attribute [rw] insert_id
       #   @return [String]
       #     Optional. A unique identifier for the log entry. If you provide a value,
       #     then Stackdriver Logging considers other log entries in the same project,
-      #     with the same +timestamp+, and with the same +insert_id+ to be duplicates
+      #     with the same `timestamp`, and with the same `insert_id` to be duplicates
       #     which can be removed.  If omitted in new log entries, then Stackdriver
-      #     Logging assigns its own unique identifier. The +insert_id+ is also used
-      #     to order log entries that have the same +timestamp+ value.
+      #     Logging assigns its own unique identifier. The `insert_id` is also used
+      #     to order log entries that have the same `timestamp` value.
       # @!attribute [rw] http_request
       #   @return [Google::Logging::Type::HttpRequest]
       #     Optional. Information about the HTTP request associated with this
@@ -100,7 +100,7 @@ module Google
       # @!attribute [rw] metadata
       #   @return [Google::Api::MonitoredResourceMetadata]
       #     Output only. Additional metadata about the monitored resource.
-      #     Only +k8s_container+, +k8s_pod+, and +k8s_node+ MonitoredResources have
+      #     Only `k8s_container`, `k8s_pod`, and `k8s_node` MonitoredResources have
       #     this field populated.
       # @!attribute [rw] operation
       #   @return [Google::Logging::V2::LogEntryOperation]
@@ -110,8 +110,8 @@ module Google
       #   @return [String]
       #     Optional. Resource name of the trace associated with the log entry, if any.
       #     If it contains a relative resource name, the name is assumed to be relative
-      #     to +//tracing.googleapis.com+. Example:
-      #     +projects/my-projectid/traces/06796866738c859f2f19b7cfb3214824+
+      #     to `//tracing.googleapis.com`. Example:
+      #     `projects/my-projectid/traces/06796866738c859f2f19b7cfb3214824`
       # @!attribute [rw] span_id
       #   @return [String]
       #     Optional. The span ID within the trace associated with the log entry. For
@@ -133,8 +133,8 @@ module Google
       # @!attribute [rw] producer
       #   @return [String]
       #     Optional. An arbitrary producer identifier. The combination of
-      #     +id+ and +producer+ must be globally unique.  Examples for +producer+:
-      #     +"MyDivision.MyBigCompany.com"+, +"github.com/MyProject/MyApplication"+.
+      #     `id` and `producer` must be globally unique.  Examples for `producer`:
+      #     `"MyDivision.MyBigCompany.com"`, `"github.com/MyProject/MyApplication"`.
       # @!attribute [rw] first
       #   @return [true, false]
       #     Optional. Set this to True if this is the first log entry in the operation.
@@ -159,7 +159,7 @@ module Google
       #     optional context such as the class or package name. This information may be
       #     used in contexts such as the logs viewer, where a file and line number are
       #     less meaningful. The format can vary by language. For example:
-      #     +qual.if.ied.Class.method+ (Java), +dir/package.func+ (Go), +function+
+      #     `qual.if.ied.Class.method` (Java), `dir/package.func` (Go), `function`
       #     (Python).
       class LogEntrySourceLocation; end
     end

data/lib/google/cloud/logging/v2/doc/google/logging/v2/logging.rb

@@ -26,9 +26,9 @@ module Google
       #         "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
       #         "folders/[FOLDER_ID]/logs/[LOG_ID]"
       #
-      #     +[LOG_ID]+ must be URL-encoded. For example,
-      #     +"projects/my-project-id/logs/syslog"+,
-      #     +"organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"+.
+      #     `[LOG_ID]` must be URL-encoded. For example,
+      #     `"projects/my-project-id/logs/syslog"`,
+      #     `"organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"`.
       #     For more information about log names, see
       #     {Google::Logging::V2::LogEntry LogEntry}.
       class DeleteLogRequest; end
@@ -37,22 +37,22 @@ module Google
       # @!attribute [rw] log_name
       #   @return [String]
       #     Optional. A default log resource name that is assigned to all log entries
-      #     in +entries+ that do not specify a value for +log_name+:
+      #     in `entries` that do not specify a value for `log_name`:
       #
       #         "projects/[PROJECT_ID]/logs/[LOG_ID]"
       #         "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
       #         "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
       #         "folders/[FOLDER_ID]/logs/[LOG_ID]"
       #
-      #     +[LOG_ID]+ must be URL-encoded. For example,
-      #     +"projects/my-project-id/logs/syslog"+ or
-      #     +"organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"+.
+      #     `[LOG_ID]` must be URL-encoded. For example,
+      #     `"projects/my-project-id/logs/syslog"` or
+      #     `"organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"`.
       #     For more information about log names, see
       #     {Google::Logging::V2::LogEntry LogEntry}.
       # @!attribute [rw] resource
       #   @return [Google::Api::MonitoredResource]
       #     Optional. A default monitored resource object that is assigned to all log
-      #     entries in +entries+ that do not specify a value for +resource+. Example:
+      #     entries in `entries` that do not specify a value for `resource`. Example:
       #
       #         { "type": "gce_instance",
       #           "labels": {
@@ -61,33 +61,33 @@ module Google
       #     See {Google::Logging::V2::LogEntry LogEntry}.
       # @!attribute [rw] labels
       #   @return [Hash{String => String}]
-      #     Optional. Default labels that are added to the +labels+ field of all log
-      #     entries in +entries+. If a log entry already has a label with the same key
+      #     Optional. Default labels that are added to the `labels` field of all log
+      #     entries in `entries`. If a log entry already has a label with the same key
       #     as a label in this parameter, then the log entry's label is not changed.
       #     See {Google::Logging::V2::LogEntry LogEntry}.
       # @!attribute [rw] entries
       #   @return [Array<Google::Logging::V2::LogEntry>]
       #     Required. The log entries to send to Stackdriver Logging. The order of log
       #     entries in this list does not matter. Values supplied in this method's
-      #     +log_name+, +resource+, and +labels+ fields are copied into those log
+      #     `log_name`, `resource`, and `labels` fields are copied into those log
       #     entries in this list that do not include values for their corresponding
       #     fields. For more information, see the
       #     {Google::Logging::V2::LogEntry LogEntry} type.
       #
-      #     If the +timestamp+ or +insert_id+ fields are missing in log entries, then
+      #     If the `timestamp` or `insert_id` fields are missing in log entries, then
       #     this method supplies the current time or a unique identifier, respectively.
       #     The supplied values are chosen so that, among the log entries that did not
       #     supply their own values, the entries earlier in the list will sort before
-      #     the entries later in the list. See the +entries.list+ method.
+      #     the entries later in the list. See the `entries.list` method.
       #
       #     Log entries with timestamps that are more than the
       #     [logs retention period](https://cloud.google.com/logging/quota-policy) in the past or more than
-      #     24 hours in the future will not be available when calling +entries.list+.
+      #     24 hours in the future will not be available when calling `entries.list`.
       #     However, those log entries can still be exported with
       #     [LogSinks](https://cloud.google.com/logging/docs/api/tasks/exporting-logs).
       #
       #     To improve throughput and to avoid exceeding the
-      #     [quota limit](https://cloud.google.com/logging/quota-policy) for calls to +entries.write+,
+      #     [quota limit](https://cloud.google.com/logging/quota-policy) for calls to `entries.write`,
       #     you should try to include several log entries in this list,
       #     rather than calling this method for each individual log entry.
       # @!attribute [rw] partial_success
@@ -96,7 +96,7 @@ module Google
       #     entries fail due to INVALID_ARGUMENT or PERMISSION_DENIED errors. If any
       #     entry is not written, then the response status is the error associated
       #     with one of the failed entries and the response includes error details
-      #     keyed by the entries' zero-based index in the +entries.write+ method.
+      #     keyed by the entries' zero-based index in the `entries.write` method.
       # @!attribute [rw] dry_run
       #   @return [true, false]
       #     Optional. If true, the request should expect normal response, but the
@@ -111,22 +111,22 @@ module Google
       # Error details for WriteLogEntries with partial success.
       # @!attribute [rw] log_entry_errors
       #   @return [Hash{Integer => Google::Rpc::Status}]
-      #     When +WriteLogEntriesRequest.partial_success+ is true, records the error
+      #     When `WriteLogEntriesRequest.partial_success` is true, records the error
       #     status for entries that were not written due to a permanent error, keyed
-      #     by the entry's zero-based index in +WriteLogEntriesRequest.entries+.
+      #     by the entry's zero-based index in `WriteLogEntriesRequest.entries`.
       #
       #     Failed requests for which no entries are written will not include
       #     per-entry errors.
       class WriteLogEntriesPartialErrors; end
 
-      # The parameters to +ListLogEntries+.
+      # The parameters to `ListLogEntries`.
       # @!attribute [rw] project_ids
       #   @return [Array<String>]
-      #     Deprecated. Use +resource_names+ instead.  One or more project identifiers
+      #     Deprecated. Use `resource_names` instead.  One or more project identifiers
       #     or project numbers from which to retrieve log entries.  Example:
-      #     +"my-project-1A"+. If present, these project identifiers are converted to
+      #     `"my-project-1A"`. If present, these project identifiers are converted to
       #     resource name format and added to the list of resources in
-      #     +resource_names+.
+      #     `resource_names`.
       # @!attribute [rw] resource_names
       #   @return [Array<String>]
       #     Required. Names of one or more parent resources from which to
@@ -137,53 +137,53 @@ module Google
       #         "billingAccounts/[BILLING_ACCOUNT_ID]"
       #         "folders/[FOLDER_ID]"
       #
-      #     Projects listed in the +project_ids+ field are added to this list.
+      #     Projects listed in the `project_ids` field are added to this list.
       # @!attribute [rw] filter
       #   @return [String]
       #     Optional. A filter that chooses which log entries to return.  See [Advanced
       #     Logs Filters](/logging/docs/view/advanced_filters).  Only log entries that
       #     match the filter are returned.  An empty filter matches all log entries in
-      #     the resources listed in +resource_names+. Referencing a parent resource
-      #     that is not listed in +resource_names+ will cause the filter to return no
+      #     the resources listed in `resource_names`. Referencing a parent resource
+      #     that is not listed in `resource_names` will cause the filter to return no
       #     results.
       #     The maximum length of the filter is 20000 characters.
       # @!attribute [rw] order_by
       #   @return [String]
       #     Optional. How the results should be sorted.  Presently, the only permitted
-      #     values are +"timestamp asc"+ (default) and +"timestamp desc"+. The first
+      #     values are `"timestamp asc"` (default) and `"timestamp desc"`. The first
       #     option returns entries in order of increasing values of
-      #     +LogEntry.timestamp+ (oldest first), and the second option returns entries
+      #     `LogEntry.timestamp` (oldest first), and the second option returns entries
       #     in order of decreasing timestamps (newest first).  Entries with equal
-      #     timestamps are returned in order of their +insert_id+ values.
+      #     timestamps are returned in order of their `insert_id` values.
       # @!attribute [rw] page_size
       #   @return [Integer]
       #     Optional. The maximum number of results to return from this request.
-      #     Non-positive values are ignored.  The presence of +next_page_token+ in the
+      #     Non-positive values are ignored.  The presence of `next_page_token` in the
       #     response indicates that more results might be available.
       # @!attribute [rw] page_token
       #   @return [String]
       #     Optional. If present, then retrieve the next batch of results from the
-      #     preceding call to this method.  +page_token+ must be the value of
-      #     +next_page_token+ from the previous response.  The values of other method
+      #     preceding call to this method.  `page_token` must be the value of
+      #     `next_page_token` from the previous response.  The values of other method
       #     parameters should be identical to those in the previous call.
       class ListLogEntriesRequest; end
 
-      # Result returned from +ListLogEntries+.
+      # Result returned from `ListLogEntries`.
       # @!attribute [rw] entries
       #   @return [Array<Google::Logging::V2::LogEntry>]
-      #     A list of log entries.  If +entries+ is empty, +nextPageToken+ may still be
-      #     returned, indicating that more entries may exist.  See +nextPageToken+ for
+      #     A list of log entries.  If `entries` is empty, `nextPageToken` may still be
+      #     returned, indicating that more entries may exist.  See `nextPageToken` for
       #     more information.
       # @!attribute [rw] next_page_token
       #   @return [String]
       #     If there might be more results than those appearing in this response, then
-      #     +nextPageToken+ is included.  To get the next set of results, call this
-      #     method again using the value of +nextPageToken+ as +pageToken+.
+      #     `nextPageToken` is included.  To get the next set of results, call this
+      #     method again using the value of `nextPageToken` as `pageToken`.
       #
-      #     If a value for +next_page_token+ appears and the +entries+ field is empty,
+      #     If a value for `next_page_token` appears and the `entries` field is empty,
       #     it means that the search found no log entries so far but it did not have
       #     time to search all the possible log entries.  Retry the method with this
-      #     value for +page_token+ to continue the search.  Alternatively, consider
+      #     value for `page_token` to continue the search.  Alternatively, consider
       #     speeding up the search by changing your filter to specify a single log name
       #     or resource type, or to narrow the time range of the search.
       class ListLogEntriesResponse; end
@@ -192,13 +192,13 @@ module Google
       # @!attribute [rw] page_size
       #   @return [Integer]
       #     Optional. The maximum number of results to return from this request.
-      #     Non-positive values are ignored.  The presence of +nextPageToken+ in the
+      #     Non-positive values are ignored.  The presence of `nextPageToken` in the
       #     response indicates that more results might be available.
       # @!attribute [rw] page_token
       #   @return [String]
       #     Optional. If present, then retrieve the next batch of results from the
-      #     preceding call to this method.  +pageToken+ must be the value of
-      #     +nextPageToken+ from the previous response.  The values of other method
+      #     preceding call to this method.  `pageToken` must be the value of
+      #     `nextPageToken` from the previous response.  The values of other method
       #     parameters should be identical to those in the previous call.
       class ListMonitoredResourceDescriptorsRequest; end
 
@@ -209,8 +209,8 @@ module Google
       # @!attribute [rw] next_page_token
       #   @return [String]
       #     If there might be more results than those appearing in this response, then
-      #     +nextPageToken+ is included.  To get the next set of results, call this
-      #     method again using the value of +nextPageToken+ as +pageToken+.
+      #     `nextPageToken` is included.  To get the next set of results, call this
+      #     method again using the value of `nextPageToken` as `pageToken`.
       class ListMonitoredResourceDescriptorsResponse; end
 
       # The parameters to ListLogs.
@@ -225,13 +225,13 @@ module Google
       # @!attribute [rw] page_size
       #   @return [Integer]
       #     Optional. The maximum number of results to return from this request.
-      #     Non-positive values are ignored.  The presence of +nextPageToken+ in the
+      #     Non-positive values are ignored.  The presence of `nextPageToken` in the
       #     response indicates that more results might be available.
       # @!attribute [rw] page_token
       #   @return [String]
       #     Optional. If present, then retrieve the next batch of results from the
-      #     preceding call to this method.  +pageToken+ must be the value of
-      #     +nextPageToken+ from the previous response.  The values of other method
+      #     preceding call to this method.  `pageToken` must be the value of
+      #     `nextPageToken` from the previous response.  The values of other method
       #     parameters should be identical to those in the previous call.
       class ListLogsRequest; end
 
@@ -239,13 +239,13 @@ module Google
       # @!attribute [rw] log_names
       #   @return [Array<String>]
       #     A list of log names. For example,
-      #     +"projects/my-project/syslog"+ or
-      #     +"organizations/123/cloudresourcemanager.googleapis.com%2Factivity"+.
+      #     `"projects/my-project/syslog"` or
+      #     `"organizations/123/cloudresourcemanager.googleapis.com%2Factivity"`.
       # @!attribute [rw] next_page_token
       #   @return [String]
       #     If there might be more results than those appearing in this response, then
-      #     +nextPageToken+ is included.  To get the next set of results, call this
-      #     method again using the value of +nextPageToken+ as +pageToken+.
+      #     `nextPageToken` is included.  To get the next set of results, call this
+      #     method again using the value of `nextPageToken` as `pageToken`.
       class ListLogsResponse; end
     end
   end