Skip to content

Commit 6f8a554

Browse files
Google APIscopybara-github
Google APIs
authored and
copybara-github
committed
feat: Publish VM Extension Event logging proto for documentation
PiperOrigin-RevId: 882862265
1 parent d252e59 commit 6f8a554

3 files changed

Lines changed: 294 additions & 0 deletions

File tree

‎google/compute/logging/agentcontrolplane/v1/BUILD.bazel‎

Lines changed: 206 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,206 @@
1+
# This file was automatically generated by BuildFileGenerator
2+
3+
# buildifier: disable=load-on-top
4+
5+
# This is an API workspace, having public visibility by default makes perfect sense.
6+
package(default_visibility = ["//visibility:public"])
7+
8+
##############################################################################
9+
# Common
10+
##############################################################################
11+
load("@rules_proto//proto:defs.bzl", "proto_library")
12+
13+
proto_library(
14+
name = "agentcontrolplane_proto",
15+
srcs = [
16+
"logs.proto",
17+
],
18+
deps = [
19+
"@com_google_protobuf//:timestamp_proto",
20+
],
21+
)
22+
23+
##############################################################################
24+
# Java
25+
##############################################################################
26+
# buildifier: disable=same-origin-load
27+
load(
28+
"@com_google_googleapis_imports//:imports.bzl",
29+
"java_gapic_assembly_gradle_pkg",
30+
"java_proto_library",
31+
)
32+
33+
java_proto_library(
34+
name = "agentcontrolplane_java_proto",
35+
deps = [":agentcontrolplane_proto"],
36+
)
37+
38+
# Open Source Packages
39+
java_gapic_assembly_gradle_pkg(
40+
name = "google-compute-logging-agentcontrolplane-v1-java",
41+
deps = [
42+
":agentcontrolplane_java_proto",
43+
":agentcontrolplane_proto",
44+
],
45+
)
46+
47+
##############################################################################
48+
# Go
49+
##############################################################################
50+
# buildifier: disable=same-origin-load
51+
load(
52+
"@com_google_googleapis_imports//:imports.bzl",
53+
"go_gapic_assembly_pkg",
54+
"go_grpc_library",
55+
)
56+
57+
go_grpc_library(
58+
name = "agentcontrolplane_go_proto",
59+
importpath = "google.golang.org/genproto/googleapis/compute/logging/agentcontrolplane/v1",
60+
protos = [":agentcontrolplane_proto"],
61+
deps = [],
62+
)
63+
64+
go_gapic_assembly_pkg(
65+
name = "google-compute-logging-agentcontrolplane-v1-go",
66+
deps = [
67+
":agentcontrolplane_go_proto",
68+
],
69+
)
70+
71+
##############################################################################
72+
# Python
73+
##############################################################################
74+
# buildifier: disable=same-origin-load
75+
load(
76+
"@com_google_googleapis_imports//:imports.bzl",
77+
"moved_proto_library",
78+
"py_gapic_assembly_pkg",
79+
"py_gapic_library",
80+
"py_grpc_library",
81+
"py_proto_library",
82+
)
83+
84+
moved_proto_library(
85+
name = "agentcontrolplane_moved_proto",
86+
srcs = [":agentcontrolplane_proto"],
87+
deps = [
88+
"@com_google_protobuf//:timestamp_proto",
89+
],
90+
)
91+
92+
py_proto_library(
93+
name = "agentcontrolplane_py_proto",
94+
deps = [":agentcontrolplane_moved_proto"],
95+
)
96+
97+
py_grpc_library(
98+
name = "agentcontrolplane_py_grpc",
99+
srcs = [":agentcontrolplane_moved_proto"],
100+
deps = [":agentcontrolplane_py_proto"],
101+
)
102+
103+
py_gapic_library(
104+
name = "agentcontrolplane_py_gapic",
105+
srcs = [":agentcontrolplane_proto"],
106+
rest_numeric_enums = False,
107+
transport = "grpc+rest",
108+
)
109+
110+
# Open Source Packages
111+
py_gapic_assembly_pkg(
112+
name = "google-compute-logging-agentcontrolplane-v1-py",
113+
deps = [
114+
":agentcontrolplane_py_gapic",
115+
],
116+
)
117+
118+
##############################################################################
119+
# PHP
120+
##############################################################################
121+
# buildifier: disable=same-origin-load
122+
load(
123+
"@com_google_googleapis_imports//:imports.bzl",
124+
"php_gapic_assembly_pkg",
125+
"php_proto_library",
126+
)
127+
128+
php_proto_library(
129+
name = "agentcontrolplane_php_proto",
130+
deps = [":agentcontrolplane_proto"],
131+
)
132+
133+
php_gapic_assembly_pkg(
134+
name = "google-compute-logging-agentcontrolplane-v1-php",
135+
deps = [
136+
":agentcontrolplane_php_proto",
137+
],
138+
)
139+
140+
##############################################################################
141+
# Ruby
142+
##############################################################################
143+
# buildifier: disable=same-origin-load
144+
load(
145+
"@com_google_googleapis_imports//:imports.bzl",
146+
"ruby_grpc_library",
147+
"ruby_proto_library",
148+
)
149+
150+
ruby_proto_library(
151+
name = "agentcontrolplane_ruby_proto",
152+
deps = [":agentcontrolplane_proto"],
153+
)
154+
155+
ruby_grpc_library(
156+
name = "agentcontrolplane_ruby_grpc",
157+
srcs = [":agentcontrolplane_proto"],
158+
deps = [":agentcontrolplane_ruby_proto"],
159+
)
160+
161+
##############################################################################
162+
# C#
163+
##############################################################################
164+
# buildifier: disable=same-origin-load
165+
load(
166+
"@com_google_googleapis_imports//:imports.bzl",
167+
"csharp_gapic_assembly_pkg",
168+
"csharp_proto_library",
169+
)
170+
171+
csharp_proto_library(
172+
name = "agentcontrolplane_csharp_proto",
173+
deps = [":agentcontrolplane_proto"],
174+
)
175+
176+
# Open Source Packages
177+
csharp_gapic_assembly_pkg(
178+
name = "google-compute-logging-agentcontrolplane-v1-csharp",
179+
package_name = "Google.Compute.Logging.AgentControlPlane.V1",
180+
generate_nongapic_package = True,
181+
deps = [
182+
":agentcontrolplane_csharp_proto",
183+
],
184+
)
185+
186+
##############################################################################
187+
# C++
188+
##############################################################################
189+
# buildifier: disable=same-origin-load
190+
load(
191+
"@com_google_googleapis_imports//:imports.bzl",
192+
"cc_grpc_library",
193+
"cc_proto_library",
194+
)
195+
196+
cc_proto_library(
197+
name = "agentcontrolplane_cc_proto",
198+
deps = [":agentcontrolplane_proto"],
199+
)
200+
201+
cc_grpc_library(
202+
name = "agentcontrolplane_cc_grpc",
203+
srcs = [":agentcontrolplane_proto"],
204+
grpc_only = True,
205+
deps = [":agentcontrolplane_cc_proto"],
206+
)

‎google/compute/logging/agentcontrolplane/v1/README.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
# VM Extension Event Logging
2+
3+
These protos represent the VM Extension Event log entry schema.

‎google/compute/logging/agentcontrolplane/v1/logs.proto‎

Lines changed: 85 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,85 @@
1+
// Copyright 2026 Google LLC
2+
//
3+
// Licensed under the Apache License, Version 2.0 (the "License");
4+
// you may not use this file except in compliance with the License.
5+
// You may obtain a copy of the License at
6+
//
7+
// http://www.apache.org/licenses/LICENSE-2.0
8+
//
9+
// Unless required by applicable law or agreed to in writing, software
10+
// distributed under the License is distributed on an "AS IS" BASIS,
11+
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12+
// See the License for the specific language governing permissions and
13+
// limitations under the License.
14+
15+
syntax = "proto3";
16+
17+
package google.compute.logging.agentcontrolplane.v1;
18+
19+
import "google/protobuf/timestamp.proto";
20+
21+
option csharp_namespace = "Google.Compute.Logging.AgentControlPlane.V1";
22+
option go_package = "google.golang.org/genproto/googleapis/compute/logging/agentcontrolplane/v1;agentcontrolplane";
23+
option java_multiple_files = true;
24+
option java_outer_classname = "LogsProto";
25+
option java_package = "com.google.compute.logging.agentcontrolplane.v1";
26+
option php_namespace = "Google\\Compute\\Logging\\AgentControlPlane\\V1";
27+
option ruby_package = "Google::Compute::Logging::AgentControlPlane::V1";
28+
29+
// This file defines the format of Cloud Agent Control Plane Logging Logs.
30+
31+
// Log message used to send Platform Logging for critical events in VM Extension
32+
// lifecycle.
33+
message VmExtensionEvent {
34+
// Enum for the types of events that are critical in VM Extension lifecycle.
35+
enum ExtensionEventType {
36+
// Unspecified event type, used as a default value.
37+
EXTENSION_EVENT_TYPE_UNSPECIFIED = 0;
38+
39+
// Event indicating that the extension has crashed.
40+
// This indicates that the extension was once installed and started
41+
// successfully, but then crashed.
42+
CRASHED = 1;
43+
44+
// Event indicating that the extension install has failed.
45+
INSTALL_FAILED = 2;
46+
47+
// Event indicating that the extension is installed and started
48+
// successfully.
49+
INSTALLED = 3;
50+
51+
// Event indicating that the extension rollback has failed.
52+
ROLLBACK_FAILED = 4;
53+
54+
// Event indicating that the extension rollback has succeeded.
55+
ROLLED_BACK = 5;
56+
57+
// Event indicating that none of the extension revision candidates satisfies
58+
// the install requirements, e.g. operating system and/or architecture.
59+
INCOMPATIBLE = 6;
60+
61+
// The service requiring this extension is disabled.
62+
SERVICE_DISABLED = 7;
63+
}
64+
65+
// Event timestamp.
66+
google.protobuf.Timestamp timestamp = 1;
67+
68+
// Type of event that is critical in VM Extension lifecycle.
69+
ExtensionEventType event_type = 2;
70+
71+
// Name of the VM extension.
72+
string extension_name = 3;
73+
74+
// Policy ID that is associated with this VM extension event if applicable.
75+
// Format:
76+
// projects/{project}/zones/{zone}/vmExtensionPolicies/{vmExtensionPolicy} or
77+
// projects/{project}/global/vmExtensionPolicies/{vmExtensionPolicy}
78+
string policy_id = 4;
79+
80+
// Revision ID of the VM extension.
81+
string revision_id = 5;
82+
83+
// Message that describes the event in detail.
84+
string event_message = 6;
85+
}

0 commit comments

Comments
 (0)