google-cloud-logging-v2 0.1.0

data/proto_docs/google/api/resource.rb

@@ -0,0 +1,247 @@
+# frozen_string_literal: true
+
+# Copyright 2020 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Api
+    # A simple descriptor of a resource type.
+    #
+    # ResourceDescriptor annotates a resource message (either by means of a
+    # protobuf annotation or use in the service config), and associates the
+    # resource's schema, the resource type, and the pattern of the resource name.
+    #
+    # Example:
+    #
+    #     message Topic {
+    #       // Indicates this message defines a resource schema.
+    #       // Declares the resource type in the format of {service}/{kind}.
+    #       // For Kubernetes resources, the format is {api group}/{kind}.
+    #       option (google.api.resource) = {
+    #         type: "pubsub.googleapis.com/Topic"
+    #         name_descriptor: {
+    #           pattern: "projects/{project}/topics/{topic}"
+    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
+    #           parent_name_extractor: "projects/{project}"
+    #         }
+    #       };
+    #     }
+    #
+    # The ResourceDescriptor Yaml config will look like:
+    #
+    #    resources:
+    #    - type: "pubsub.googleapis.com/Topic"
+    #      name_descriptor:
+    #        - pattern: "projects/\\{project}/topics/\\{topic}"
+    #          parent_type: "cloudresourcemanager.googleapis.com/Project"
+    #          parent_name_extractor: "projects/\\{project}"
+    #
+    # Sometimes, resources have multiple patterns, typically because they can
+    # live under multiple parents.
+    #
+    # Example:
+    #
+    #     message LogEntry {
+    #       option (google.api.resource) = {
+    #         type: "logging.googleapis.com/LogEntry"
+    #         name_descriptor: {
+    #           pattern: "projects/{project}/logs/{log}"
+    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
+    #           parent_name_extractor: "projects/{project}"
+    #         }
+    #         name_descriptor: {
+    #           pattern: "folders/{folder}/logs/{log}"
+    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
+    #           parent_name_extractor: "folders/{folder}"
+    #         }
+    #         name_descriptor: {
+    #           pattern: "organizations/{organization}/logs/{log}"
+    #           parent_type: "cloudresourcemanager.googleapis.com/Organization"
+    #           parent_name_extractor: "organizations/{organization}"
+    #         }
+    #         name_descriptor: {
+    #           pattern: "billingAccounts/{billing_account}/logs/{log}"
+    #           parent_type: "billing.googleapis.com/BillingAccount"
+    #           parent_name_extractor: "billingAccounts/{billing_account}"
+    #         }
+    #       };
+    #     }
+    #
+    # The ResourceDescriptor Yaml config will look like:
+    #
+    #     resources:
+    #     - type: 'logging.googleapis.com/LogEntry'
+    #       name_descriptor:
+    #         - pattern: "projects/{project}/logs/{log}"
+    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
+    #           parent_name_extractor: "projects/{project}"
+    #         - pattern: "folders/{folder}/logs/{log}"
+    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
+    #           parent_name_extractor: "folders/{folder}"
+    #         - pattern: "organizations/{organization}/logs/{log}"
+    #           parent_type: "cloudresourcemanager.googleapis.com/Organization"
+    #           parent_name_extractor: "organizations/{organization}"
+    #         - pattern: "billingAccounts/{billing_account}/logs/{log}"
+    #           parent_type: "billing.googleapis.com/BillingAccount"
+    #           parent_name_extractor: "billingAccounts/{billing_account}"
+    #
+    # For flexible resources, the resource name doesn't contain parent names, but
+    # the resource itself has parents for policy evaluation.
+    #
+    # Example:
+    #
+    #     message Shelf {
+    #       option (google.api.resource) = {
+    #         type: "library.googleapis.com/Shelf"
+    #         name_descriptor: {
+    #           pattern: "shelves/{shelf}"
+    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
+    #         }
+    #         name_descriptor: {
+    #           pattern: "shelves/{shelf}"
+    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
+    #         }
+    #       };
+    #     }
+    #
+    # The ResourceDescriptor Yaml config will look like:
+    #
+    #     resources:
+    #     - type: 'library.googleapis.com/Shelf'
+    #       name_descriptor:
+    #         - pattern: "shelves/{shelf}"
+    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
+    #         - pattern: "shelves/{shelf}"
+    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
+    # @!attribute [rw] type
+    #   @return [::String]
+    #     The resource type. It must be in the format of
+    #     \\{service_name}/\\{resource_type_kind}. The `resource_type_kind` must be
+    #     singular and must not include version numbers.
+    #
+    #     Example: `storage.googleapis.com/Bucket`
+    #
+    #     The value of the resource_type_kind must follow the regular expression
+    #     /[A-Za-z][a-zA-Z0-9]+/. It should start with an upper case character and
+    #     should use PascalCase (UpperCamelCase). The maximum number of
+    #     characters allowed for the `resource_type_kind` is 100.
+    # @!attribute [rw] pattern
+    #   @return [::Array<::String>]
+    #     Optional. The relative resource name pattern associated with this resource
+    #     type. The DNS prefix of the full resource name shouldn't be specified here.
+    #
+    #     The path pattern must follow the syntax, which aligns with HTTP binding
+    #     syntax:
+    #
+    #         Template = Segment { "/" Segment } ;
+    #         Segment = LITERAL | Variable ;
+    #         Variable = "{" LITERAL "}" ;
+    #
+    #     Examples:
+    #
+    #         - "projects/\\{project}/topics/\\{topic}"
+    #         - "projects/\\{project}/knowledgeBases/\\{knowledge_base}"
+    #
+    #     The components in braces correspond to the IDs for each resource in the
+    #     hierarchy. It is expected that, if multiple patterns are provided,
+    #     the same component name (e.g. "project") refers to IDs of the same
+    #     type of resource.
+    # @!attribute [rw] name_field
+    #   @return [::String]
+    #     Optional. The field on the resource that designates the resource name
+    #     field. If omitted, this is assumed to be "name".
+    # @!attribute [rw] history
+    #   @return [::Google::Api::ResourceDescriptor::History]
+    #     Optional. The historical or future-looking state of the resource pattern.
+    #
+    #     Example:
+    #
+    #         // The InspectTemplate message originally only supported resource
+    #         // names with organization, and project was added later.
+    #         message InspectTemplate {
+    #           option (google.api.resource) = {
+    #             type: "dlp.googleapis.com/InspectTemplate"
+    #             pattern:
+    #             "organizations/{organization}/inspectTemplates/{inspect_template}"
+    #             pattern: "projects/{project}/inspectTemplates/{inspect_template}"
+    #             history: ORIGINALLY_SINGLE_PATTERN
+    #           };
+    #         }
+    # @!attribute [rw] plural
+    #   @return [::String]
+    #     The plural name used in the resource name, such as 'projects' for
+    #     the name of 'projects/\\{project}'. It is the same concept of the `plural`
+    #     field in k8s CRD spec
+    #     https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
+    # @!attribute [rw] singular
+    #   @return [::String]
+    #     The same concept of the `singular` field in k8s CRD spec
+    #     https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
+    #     Such as "project" for the `resourcemanager.googleapis.com/Project` type.
+    class ResourceDescriptor
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+
+      # A description of the historical or future-looking state of the
+      # resource pattern.
+      module History
+        # The "unset" value.
+        HISTORY_UNSPECIFIED = 0
+
+        # The resource originally had one pattern and launched as such, and
+        # additional patterns were added later.
+        ORIGINALLY_SINGLE_PATTERN = 1
+
+        # The resource has one pattern, but the API owner expects to add more
+        # later. (This is the inverse of ORIGINALLY_SINGLE_PATTERN, and prevents
+        # that from being necessary once there are multiple patterns.)
+        FUTURE_MULTI_PATTERN = 2
+      end
+    end
+
+    # Defines a proto annotation that describes a string field that refers to
+    # an API resource.
+    # @!attribute [rw] type
+    #   @return [::String]
+    #     The resource type that the annotated field references.
+    #
+    #     Example:
+    #
+    #         message Subscription {
+    #           string topic = 2 [(google.api.resource_reference) = {
+    #             type: "pubsub.googleapis.com/Topic"
+    #           }];
+    #         }
+    # @!attribute [rw] child_type
+    #   @return [::String]
+    #     The resource type of a child collection that the annotated field
+    #     references. This is useful for annotating the `parent` field that
+    #     doesn't have a fixed resource type.
+    #
+    #     Example:
+    #
+    #       message ListLogEntriesRequest {
+    #         string parent = 1 [(google.api.resource_reference) = {
+    #           child_type: "logging.googleapis.com/LogEntry"
+    #         };
+    #       }
+    class ResourceReference
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+  end
+end

data/proto_docs/google/logging/type/http_request.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+# Copyright 2020 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Logging
+      module Type
+        # A common proto for logging HTTP requests. Only contains semantics
+        # defined by the HTTP specification. Product-specific logging
+        # information MUST be defined in a separate message.
+        # @!attribute [rw] request_method
+        #   @return [::String]
+        #     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"`.
+        # @!attribute [rw] request_size
+        #   @return [::Integer]
+        #     The size of the HTTP request message in bytes, including the request
+        #     headers and the request body.
+        # @!attribute [rw] status
+        #   @return [::Integer]
+        #     The response code indicating the status of response.
+        #     Examples: 200, 404.
+        # @!attribute [rw] response_size
+        #   @return [::Integer]
+        #     The size of the HTTP response message sent back to the client, in bytes,
+        #     including the response headers and the response body.
+        # @!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)"`.
+        # @!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"`.
+        # @!attribute [rw] server_ip
+        #   @return [::String]
+        #     The IP address (IPv4 or IPv6) of the origin server that the request was
+        #     sent to.
+        # @!attribute [rw] referer
+        #   @return [::String]
+        #     The referer URL of the request, as defined in
+        #     [HTTP/1.1 Header Field
+        #     Definitions](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).
+        # @!attribute [rw] latency
+        #   @return [::Google::Protobuf::Duration]
+        #     The request processing latency on the server, from the time the request was
+        #     received until the response was sent.
+        # @!attribute [rw] cache_lookup
+        #   @return [::Boolean]
+        #     Whether or not a cache lookup was attempted.
+        # @!attribute [rw] cache_hit
+        #   @return [::Boolean]
+        #     Whether or not an entity was served from cache
+        #     (with or without validation).
+        # @!attribute [rw] cache_validated_with_origin_server
+        #   @return [::Boolean]
+        #     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
+        #     True.
+        # @!attribute [rw] cache_fill_bytes
+        #   @return [::Integer]
+        #     The number of HTTP response bytes inserted into cache. Set only when a
+        #     cache fill was attempted.
+        # @!attribute [rw] protocol
+        #   @return [::String]
+        #     Protocol used for the request. Examples: "HTTP/1.1", "HTTP/2", "websocket"
+        class HttpRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/logging/type/log_severity.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+# Copyright 2020 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Logging
+      module Type
+        # The severity of the event described in a log entry, expressed as one of the
+        # standard severity levels listed below.  For your reference, the levels are
+        # assigned the listed numeric values. The effect of using numeric values other
+        # than those listed is undefined.
+        #
+        # You can filter for log entries by severity.  For example, the following
+        # filter expression will match log entries with severities `INFO`, `NOTICE`,
+        # and `WARNING`:
+        #
+        #     severity > DEBUG AND severity <= WARNING
+        #
+        # If you are writing log entries, you should map other severity encodings to
+        # one of these standard levels. For example, you might map all of Java's FINE,
+        # FINER, and FINEST levels to `LogSeverity.DEBUG`. You can preserve the
+        # original severity level in the log entry payload if you wish.
+        module LogSeverity
+          # (0) The log entry has no assigned severity level.
+          DEFAULT = 0
+
+          # (100) Debug or trace information.
+          DEBUG = 100
+
+          # (200) Routine information, such as ongoing status or performance.
+          INFO = 200
+
+          # (300) Normal but significant events, such as start up, shut down, or
+          # a configuration change.
+          NOTICE = 300
+
+          # (400) Warning events might cause problems.
+          WARNING = 400
+
+          # (500) Error events are likely to cause problems.
+          ERROR = 500
+
+          # (600) Critical events cause more severe problems or outages.
+          CRITICAL = 600
+
+          # (700) A person must take an action immediately.
+          ALERT = 700
+
+          # (800) One or more systems are unusable.
+          EMERGENCY = 800
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/logging/v2/log_entry.rb

@@ -0,0 +1,203 @@
+# frozen_string_literal: true
+
+# Copyright 2020 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Logging
+      module V2
+        # An individual entry in a log.
+        # @!attribute [rw] log_name
+        #   @return [::String]
+        #     Required. The resource name of the log to which this log entry belongs:
+        #
+        #         "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]"
+        #
+        #     A project number may 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.
+        #
+        #     `[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
+        #     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.
+        # @!attribute [rw] resource
+        #   @return [::Google::Api::MonitoredResource]
+        #     Required. The monitored resource that produced this log entry.
+        #
+        #     Example: a log entry that reports a database error would be associated with
+        #     the monitored resource designating the particular database that reported
+        #     the error.
+        # @!attribute [rw] proto_payload
+        #   @return [::Google::Protobuf::Any]
+        #     The log entry payload, represented as a protocol buffer. Some Google
+        #     Cloud Platform services use this field for their log entry payloads.
+        #
+        #     The following protocol buffer types are supported; user-defined types
+        #     are not supported:
+        #
+        #       "type.googleapis.com/google.cloud.audit.AuditLog"
+        #       "type.googleapis.com/google.appengine.logging.v1.RequestLog"
+        # @!attribute [rw] text_payload
+        #   @return [::String]
+        #     The log entry payload, represented as a Unicode string (UTF-8).
+        # @!attribute [rw] json_payload
+        #   @return [::Google::Protobuf::Struct]
+        #     The log entry payload, represented as a structure that is
+        #     expressed as a JSON object.
+        # @!attribute [rw] timestamp
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Optional. The time the event described by the log entry occurred. This time is used
+        #     to compute the log entry's age and to enforce the logs retention period.
+        #     If this field is omitted in a new log entry, then Logging assigns it the
+        #     current time. Timestamps have nanosecond accuracy, but trailing zeros in
+        #     the fractional seconds might be omitted when the timestamp is displayed.
+        #
+        #     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 those log entries can still be
+        #     [exported with LogSinks](https://cloud.google.com/logging/docs/api/tasks/exporting-logs).
+        # @!attribute [r] receive_timestamp
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The time the log entry was received by Logging.
+        # @!attribute [rw] severity
+        #   @return [::Google::Cloud::Logging::Type::LogSeverity]
+        #     Optional. The severity of the log entry. The default value is `LogSeverity.DEFAULT`.
+        # @!attribute [rw] insert_id
+        #   @return [::String]
+        #     Optional. A unique identifier for the log entry. If you provide a value, then
+        #     Logging considers other log entries in the same project, with the same
+        #     `timestamp`, and with the same `insert_id` to be duplicates which are
+        #     removed in a single query result. However, there are no guarantees of
+        #     de-duplication in the export of logs.
+        #
+        #     If the `insert_id` is omitted when writing a log entry, the Logging API
+        #      assigns its own unique identifier in this field.
+        #
+        #     In queries, the `insert_id` is also used to order log entries that have
+        #     the same `log_name` and `timestamp` values.
+        # @!attribute [rw] http_request
+        #   @return [::Google::Cloud::Logging::Type::HttpRequest]
+        #     Optional. Information about the HTTP request associated with this log entry, if
+        #     applicable.
+        # @!attribute [rw] labels
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     Optional. A set of user-defined (key, value) data that provides additional
+        #     information about the log entry.
+        # @!attribute [rw] operation
+        #   @return [::Google::Cloud::Logging::V2::LogEntryOperation]
+        #     Optional. Information about an operation associated with the log entry, if
+        #     applicable.
+        # @!attribute [rw] trace
+        #   @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`
+        # @!attribute [rw] span_id
+        #   @return [::String]
+        #     Optional. The span ID within the trace associated with the log entry.
+        #
+        #     For Trace spans, this is the same format that the Trace API v2 uses: a
+        #     16-character hexadecimal encoding of an 8-byte array, such as
+        #     `000000000000004a`.
+        # @!attribute [rw] trace_sampled
+        #   @return [::Boolean]
+        #     Optional. The sampling decision of the trace associated with the log entry.
+        #
+        #     True means that the trace resource name in the `trace` field was sampled
+        #     for storage in a trace backend. False means that the trace was not sampled
+        #     for storage when this log entry was written, or the sampling decision was
+        #     unknown at the time. A non-sampled `trace` value is still useful as a
+        #     request correlation identifier. The default is False.
+        # @!attribute [rw] source_location
+        #   @return [::Google::Cloud::Logging::V2::LogEntrySourceLocation]
+        #     Optional. Source code location information associated with the log entry, if any.
+        class LogEntry
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class LabelsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # Additional information about a potentially long-running operation with which
+        # a log entry is associated.
+        # @!attribute [rw] id
+        #   @return [::String]
+        #     Optional. An arbitrary operation identifier. Log entries with the same
+        #     identifier are assumed to be part of the same operation.
+        # @!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"`.
+        # @!attribute [rw] first
+        #   @return [::Boolean]
+        #     Optional. Set this to True if this is the first log entry in the operation.
+        # @!attribute [rw] last
+        #   @return [::Boolean]
+        #     Optional. Set this to True if this is the last log entry in the operation.
+        class LogEntryOperation
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Additional information about the source code location that produced the log
+        # entry.
+        # @!attribute [rw] file
+        #   @return [::String]
+        #     Optional. Source file name. Depending on the runtime environment, this
+        #     might be a simple name or a fully-qualified name.
+        # @!attribute [rw] line
+        #   @return [::Integer]
+        #     Optional. Line within the source file. 1-based; 0 indicates no line number
+        #     available.
+        # @!attribute [rw] function
+        #   @return [::String]
+        #     Optional. Human-readable name of the function or method being invoked, with
+        #     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`
+        #     (Python).
+        class LogEntrySourceLocation
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end