From eea2ebd0f0ce5397350cd1cb7cbdcab822e25159 Mon Sep 17 00:00:00 2001 From: Robin Hahling Date: Tue, 31 May 2022 17:52:50 +0200 Subject: [PATCH] codegen: use new cilium-builder image The new cilium-builder image embeds the protoc-gen-doc plugin. This means that we don't need a separate `doc` target as documentation is generated along with the code. Signed-off-by: Robin Hahling --- Dockerfile.codegen | 2 +- api/Makefile | 10 +- api/v1/Makefile.protoc | 3 + api/v1/README.md | 414 ++++++++++++++-------------- api/v1/tetragon/tetragon.pb.go | 4 +- api/v1/tetragon/tetragon_grpc.pb.go | 4 + 6 files changed, 218 insertions(+), 219 deletions(-) diff --git a/Dockerfile.codegen b/Dockerfile.codegen index 328a04eb20c..ca056019967 100644 --- a/Dockerfile.codegen +++ b/Dockerfile.codegen @@ -1,4 +1,4 @@ -FROM quay.io/cilium/cilium-builder:b7a9dcdcadd77d38db87bbd06b9bc238e9dab5a0@sha256:eecc017a6ccf0c7884f1ffcf10e58462a272f5e41c0ece09adb351e8839e3157 +FROM quay.io/cilium/cilium-builder:b7d0138c0c9bd5ed791117d924e57e99fe078b63@sha256:448b7ba8e7ae1628419b5857b80ad5c3c931d32835ea637095b1503acd0e68f7 RUN --mount=type=bind,readwrite,target=/go/src/github.com/cilium/tetragon cd /go/src/github.com/cilium/tetragon && go install ./cmd/protoc-gen-go-tetragon #- vi:ft=dockerfile -# diff --git a/api/Makefile b/api/Makefile index 1f8de2e2b11..2f3b2b3d07c 100644 --- a/api/Makefile +++ b/api/Makefile @@ -4,7 +4,7 @@ BUILDER_IMAGE=cilium/tetragon-codegen:latest .PHONY: all -all: proto doc +all: proto .PHONY: proto proto: v1 @@ -16,11 +16,3 @@ v1: --user "$(shell id -u):$(shell id -g)" \ $(BUILDER_IMAGE) \ make -C /src -f Makefile.protoc - -.PHONY: doc -doc: - docker container run --rm \ - --volume $(CURDIR)/v1:/out \ - --volume $(CURDIR)/v1/tetragon:/protos \ - pseudomuto/protoc-gen-doc:1.5.0 \ - --doc_opt=markdown,README.md diff --git a/api/v1/Makefile.protoc b/api/v1/Makefile.protoc index e1571ebb69d..f68424b7dd8 100644 --- a/api/v1/Makefile.protoc +++ b/api/v1/Makefile.protoc @@ -10,6 +10,7 @@ TETRAGON_GO_TARGETS := \ TETRAGON_PROTO_PATH := . TETRAGON_PROTOC_PLUGINS := \ + --plugin=$(GOPATH)/bin/protoc-gen-doc \ --plugin=$(GOPATH)/bin/protoc-gen-go \ --plugin=$(GOPATH)/bin/protoc-gen-go-grpc \ --plugin=$(GOPATH)/bin/protoc-gen-go-json \ @@ -21,6 +22,8 @@ all: for proto in $(TETRAGON_PROTO_SOURCES) ; do \ echo Generating $${proto} && \ $(PROTOC) $(TETRAGON_PROTOC_PLUGINS) -I $(TETRAGON_PROTO_PATH) \ + --doc_out=./ \ + --doc_opt=markdown,README.md \ --go_out=paths=source_relative:. \ --go-grpc_out=require_unimplemented_servers=false,paths=source_relative:. \ --go-json_out=orig_name=true,paths=source_relative:. \ diff --git a/api/v1/README.md b/api/v1/README.md index 877cfaefa59..b839a2dc514 100644 --- a/api/v1/README.md +++ b/api/v1/README.md @@ -3,82 +3,82 @@ ## Table of Contents -- [tetragon.proto](#tetragon.proto) - - [AddTracingPolicyRequest](#tetragon.AddTracingPolicyRequest) - - [AddTracingPolicyResponse](#tetragon.AddTracingPolicyResponse) - - [AggregationInfo](#tetragon.AggregationInfo) - - [AggregationOptions](#tetragon.AggregationOptions) - - [Capabilities](#tetragon.Capabilities) - - [Container](#tetragon.Container) - - [DeleteTracingPolicyRequest](#tetragon.DeleteTracingPolicyRequest) - - [DeleteTracingPolicyResponse](#tetragon.DeleteTracingPolicyResponse) - - [DisableSensorRequest](#tetragon.DisableSensorRequest) - - [DisableSensorResponse](#tetragon.DisableSensorResponse) - - [DnsInfo](#tetragon.DnsInfo) - - [EnableSensorRequest](#tetragon.EnableSensorRequest) - - [EnableSensorResponse](#tetragon.EnableSensorResponse) - - [Filter](#tetragon.Filter) - - [GetEventsRequest](#tetragon.GetEventsRequest) - - [GetEventsResponse](#tetragon.GetEventsResponse) - - [GetHealthStatusRequest](#tetragon.GetHealthStatusRequest) - - [GetHealthStatusResponse](#tetragon.GetHealthStatusResponse) - - [GetSensorConfigRequest](#tetragon.GetSensorConfigRequest) - - [GetSensorConfigResponse](#tetragon.GetSensorConfigResponse) - - [GetStackTraceTreeRequest](#tetragon.GetStackTraceTreeRequest) - - [GetStackTraceTreeResponse](#tetragon.GetStackTraceTreeResponse) - - [GetVersionRequest](#tetragon.GetVersionRequest) - - [GetVersionResponse](#tetragon.GetVersionResponse) - - [HealthStatus](#tetragon.HealthStatus) - - [Image](#tetragon.Image) - - [KprobeArgument](#tetragon.KprobeArgument) - - [KprobeCred](#tetragon.KprobeCred) - - [KprobeFile](#tetragon.KprobeFile) - - [KprobePath](#tetragon.KprobePath) - - [KprobeSkb](#tetragon.KprobeSkb) - - [KprobeSock](#tetragon.KprobeSock) - - [KprobeTruncatedBytes](#tetragon.KprobeTruncatedBytes) - - [ListSensorsRequest](#tetragon.ListSensorsRequest) - - [ListSensorsResponse](#tetragon.ListSensorsResponse) - - [Namespace](#tetragon.Namespace) - - [Namespaces](#tetragon.Namespaces) - - [Pod](#tetragon.Pod) - - [Process](#tetragon.Process) - - [ProcessDns](#tetragon.ProcessDns) - - [ProcessExec](#tetragon.ProcessExec) - - [ProcessExit](#tetragon.ProcessExit) - - [ProcessKprobe](#tetragon.ProcessKprobe) - - [ProcessTracepoint](#tetragon.ProcessTracepoint) - - [RemoveSensorRequest](#tetragon.RemoveSensorRequest) - - [RemoveSensorResponse](#tetragon.RemoveSensorResponse) - - [SensorStatus](#tetragon.SensorStatus) - - [SetSensorConfigRequest](#tetragon.SetSensorConfigRequest) - - [SetSensorConfigResponse](#tetragon.SetSensorConfigResponse) - - [StackAddress](#tetragon.StackAddress) - - [StackTrace](#tetragon.StackTrace) - - [StackTraceLabel](#tetragon.StackTraceLabel) - - [StackTraceNode](#tetragon.StackTraceNode) - - [Test](#tetragon.Test) +- [tetragon/tetragon.proto](#tetragon_tetragon-proto) + - [AddTracingPolicyRequest](#tetragon-AddTracingPolicyRequest) + - [AddTracingPolicyResponse](#tetragon-AddTracingPolicyResponse) + - [AggregationInfo](#tetragon-AggregationInfo) + - [AggregationOptions](#tetragon-AggregationOptions) + - [Capabilities](#tetragon-Capabilities) + - [Container](#tetragon-Container) + - [DeleteTracingPolicyRequest](#tetragon-DeleteTracingPolicyRequest) + - [DeleteTracingPolicyResponse](#tetragon-DeleteTracingPolicyResponse) + - [DisableSensorRequest](#tetragon-DisableSensorRequest) + - [DisableSensorResponse](#tetragon-DisableSensorResponse) + - [DnsInfo](#tetragon-DnsInfo) + - [EnableSensorRequest](#tetragon-EnableSensorRequest) + - [EnableSensorResponse](#tetragon-EnableSensorResponse) + - [Filter](#tetragon-Filter) + - [GetEventsRequest](#tetragon-GetEventsRequest) + - [GetEventsResponse](#tetragon-GetEventsResponse) + - [GetHealthStatusRequest](#tetragon-GetHealthStatusRequest) + - [GetHealthStatusResponse](#tetragon-GetHealthStatusResponse) + - [GetSensorConfigRequest](#tetragon-GetSensorConfigRequest) + - [GetSensorConfigResponse](#tetragon-GetSensorConfigResponse) + - [GetStackTraceTreeRequest](#tetragon-GetStackTraceTreeRequest) + - [GetStackTraceTreeResponse](#tetragon-GetStackTraceTreeResponse) + - [GetVersionRequest](#tetragon-GetVersionRequest) + - [GetVersionResponse](#tetragon-GetVersionResponse) + - [HealthStatus](#tetragon-HealthStatus) + - [Image](#tetragon-Image) + - [KprobeArgument](#tetragon-KprobeArgument) + - [KprobeCred](#tetragon-KprobeCred) + - [KprobeFile](#tetragon-KprobeFile) + - [KprobePath](#tetragon-KprobePath) + - [KprobeSkb](#tetragon-KprobeSkb) + - [KprobeSock](#tetragon-KprobeSock) + - [KprobeTruncatedBytes](#tetragon-KprobeTruncatedBytes) + - [ListSensorsRequest](#tetragon-ListSensorsRequest) + - [ListSensorsResponse](#tetragon-ListSensorsResponse) + - [Namespace](#tetragon-Namespace) + - [Namespaces](#tetragon-Namespaces) + - [Pod](#tetragon-Pod) + - [Process](#tetragon-Process) + - [ProcessDns](#tetragon-ProcessDns) + - [ProcessExec](#tetragon-ProcessExec) + - [ProcessExit](#tetragon-ProcessExit) + - [ProcessKprobe](#tetragon-ProcessKprobe) + - [ProcessTracepoint](#tetragon-ProcessTracepoint) + - [RemoveSensorRequest](#tetragon-RemoveSensorRequest) + - [RemoveSensorResponse](#tetragon-RemoveSensorResponse) + - [SensorStatus](#tetragon-SensorStatus) + - [SetSensorConfigRequest](#tetragon-SetSensorConfigRequest) + - [SetSensorConfigResponse](#tetragon-SetSensorConfigResponse) + - [StackAddress](#tetragon-StackAddress) + - [StackTrace](#tetragon-StackTrace) + - [StackTraceLabel](#tetragon-StackTraceLabel) + - [StackTraceNode](#tetragon-StackTraceNode) + - [Test](#tetragon-Test) - - [CapabilitiesType](#tetragon.CapabilitiesType) - - [EventType](#tetragon.EventType) - - [HealthStatusResult](#tetragon.HealthStatusResult) - - [HealthStatusType](#tetragon.HealthStatusType) - - [KprobeAction](#tetragon.KprobeAction) + - [CapabilitiesType](#tetragon-CapabilitiesType) + - [EventType](#tetragon-EventType) + - [HealthStatusResult](#tetragon-HealthStatusResult) + - [HealthStatusType](#tetragon-HealthStatusType) + - [KprobeAction](#tetragon-KprobeAction) - - [FineGuidanceSensors](#tetragon.FineGuidanceSensors) + - [FineGuidanceSensors](#tetragon-FineGuidanceSensors) - [Scalar Value Types](#scalar-value-types) - +

Top

-## tetragon.proto +## tetragon/tetragon.proto - + ### AddTracingPolicyRequest @@ -93,7 +93,7 @@ - + ### AddTracingPolicyResponse @@ -103,7 +103,7 @@ - + ### AggregationInfo AggregationInfo contains information about aggregation results. @@ -118,7 +118,7 @@ AggregationInfo contains information about aggregation results. - + ### AggregationOptions AggregationOptions defines configuration options for aggregating events. @@ -126,7 +126,7 @@ AggregationOptions defines configuration options for aggregating events. | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | -| window_size | [google.protobuf.Duration](#google.protobuf.Duration) | | Aggregation window size. Defaults to 15 seconds if this field is not set. | +| window_size | [google.protobuf.Duration](#google-protobuf-Duration) | | Aggregation window size. Defaults to 15 seconds if this field is not set. | | channel_buffer_size | [uint64](#uint64) | | Size of the buffer for the aggregator to receive incoming events. If the buffer becomes full, the aggregator will log a warning and start dropping incoming events. | @@ -134,7 +134,7 @@ AggregationOptions defines configuration options for aggregating events. - + ### Capabilities @@ -142,16 +142,16 @@ AggregationOptions defines configuration options for aggregating events. | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | -| permitted | [CapabilitiesType](#tetragon.CapabilitiesType) | repeated | | -| effective | [CapabilitiesType](#tetragon.CapabilitiesType) | repeated | | -| inheritable | [CapabilitiesType](#tetragon.CapabilitiesType) | repeated | | +| permitted | [CapabilitiesType](#tetragon-CapabilitiesType) | repeated | | +| effective | [CapabilitiesType](#tetragon-CapabilitiesType) | repeated | | +| inheritable | [CapabilitiesType](#tetragon-CapabilitiesType) | repeated | | - + ### Container @@ -161,9 +161,9 @@ AggregationOptions defines configuration options for aggregating events. | ----- | ---- | ----- | ----------- | | id | [string](#string) | | | | name | [string](#string) | | | -| image | [Image](#tetragon.Image) | | | -| start_time | [google.protobuf.Timestamp](#google.protobuf.Timestamp) | | Start time of the container. | -| pid | [google.protobuf.UInt32Value](#google.protobuf.UInt32Value) | | PID in the container namespace. | +| image | [Image](#tetragon-Image) | | | +| start_time | [google.protobuf.Timestamp](#google-protobuf-Timestamp) | | Start time of the container. | +| pid | [google.protobuf.UInt32Value](#google-protobuf-UInt32Value) | | PID in the container namespace. | | maybe_exec_probe | [bool](#bool) | | If this is set true, it means that the process might have been originated from a Kubernetes exec probe. For this field to be true, the following must be true: 1. The binary field matches the first element of the exec command list for either liveness or readiness probe excluding the basename. For example, "/bin/ls" and "ls" are considered a match. 2. The arguments field exactly matches the rest of the exec command list. | @@ -173,7 +173,7 @@ AggregationOptions defines configuration options for aggregating events. - + ### DeleteTracingPolicyRequest @@ -188,7 +188,7 @@ AggregationOptions defines configuration options for aggregating events. - + ### DeleteTracingPolicyResponse @@ -198,7 +198,7 @@ AggregationOptions defines configuration options for aggregating events. - + ### DisableSensorRequest @@ -213,7 +213,7 @@ AggregationOptions defines configuration options for aggregating events. - + ### DisableSensorResponse @@ -223,7 +223,7 @@ AggregationOptions defines configuration options for aggregating events. - + ### DnsInfo @@ -244,7 +244,7 @@ AggregationOptions defines configuration options for aggregating events. - + ### EnableSensorRequest @@ -259,7 +259,7 @@ AggregationOptions defines configuration options for aggregating events. - + ### EnableSensorResponse @@ -269,7 +269,7 @@ AggregationOptions defines configuration options for aggregating events. - + ### Filter @@ -279,17 +279,17 @@ AggregationOptions defines configuration options for aggregating events. | ----- | ---- | ----- | ----------- | | binary_regex | [string](#string) | repeated | | | namespace | [string](#string) | repeated | | -| health_check | [google.protobuf.BoolValue](#google.protobuf.BoolValue) | | | +| health_check | [google.protobuf.BoolValue](#google-protobuf-BoolValue) | | | | pid | [uint32](#uint32) | repeated | | | pid_set | [uint32](#uint32) | repeated | | -| event_set | [EventType](#tetragon.EventType) | repeated | | +| event_set | [EventType](#tetragon-EventType) | repeated | | - + ### GetEventsRequest @@ -297,11 +297,11 @@ AggregationOptions defines configuration options for aggregating events. | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | -| allow_list | [Filter](#tetragon.Filter) | repeated | allow_list specifies a list of filters to apply to only return certain events. If multiple filters are specified, at least one of them has to match for an event to be included in the results. | -| deny_list | [Filter](#tetragon.Filter) | repeated | deny_list specifies a list of filters to apply to exclude certain events from the results. If multiple filters are specified, at least one of them has to match for an event to be excluded. +| allow_list | [Filter](#tetragon-Filter) | repeated | allow_list specifies a list of filters to apply to only return certain events. If multiple filters are specified, at least one of them has to match for an event to be included in the results. | +| deny_list | [Filter](#tetragon-Filter) | repeated | deny_list specifies a list of filters to apply to exclude certain events from the results. If multiple filters are specified, at least one of them has to match for an event to be excluded. If both allow_list and deny_list are specified, the results contain the set difference allow_list - deny_list. | -| aggregation_options | [AggregationOptions](#tetragon.AggregationOptions) | | aggregation_options configures aggregation options for this request. If this field is not set, responses will not be aggregated. +| aggregation_options | [AggregationOptions](#tetragon-AggregationOptions) | | aggregation_options configures aggregation options for this request. If this field is not set, responses will not be aggregated. Note that currently only process_accept and process_connect events are aggregated. Other events remain unaggregated. | @@ -310,7 +310,7 @@ Note that currently only process_accept and process_connect events are aggregate - + ### GetEventsResponse @@ -318,24 +318,24 @@ Note that currently only process_accept and process_connect events are aggregate | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | -| process_exec | [ProcessExec](#tetragon.ProcessExec) | | | -| process_exit | [ProcessExit](#tetragon.ProcessExit) | | | -| process_kprobe | [ProcessKprobe](#tetragon.ProcessKprobe) | | | -| process_tracepoint | [ProcessTracepoint](#tetragon.ProcessTracepoint) | | | -| process_dns | [ProcessDns](#tetragon.ProcessDns) | | | -| test | [Test](#tetragon.Test) | | | +| process_exec | [ProcessExec](#tetragon-ProcessExec) | | | +| process_exit | [ProcessExit](#tetragon-ProcessExit) | | | +| process_kprobe | [ProcessKprobe](#tetragon-ProcessKprobe) | | | +| process_tracepoint | [ProcessTracepoint](#tetragon-ProcessTracepoint) | | | +| process_dns | [ProcessDns](#tetragon-ProcessDns) | | | +| test | [Test](#tetragon-Test) | | | | node_name | [string](#string) | | Name of the node where this event was observed. | -| time | [google.protobuf.Timestamp](#google.protobuf.Timestamp) | | Timestamp at which this event was observed. +| time | [google.protobuf.Timestamp](#google-protobuf-Timestamp) | | Timestamp at which this event was observed. For an aggregated response, this field to set to the timestamp at which the event was observed for the first time in a given aggregation time window. | -| aggregation_info | [AggregationInfo](#tetragon.AggregationInfo) | | aggregation_info contains information about aggregation results. This field is set only for aggregated responses. | +| aggregation_info | [AggregationInfo](#tetragon-AggregationInfo) | | aggregation_info contains information about aggregation results. This field is set only for aggregated responses. | - + ### GetHealthStatusRequest @@ -343,14 +343,14 @@ For an aggregated response, this field to set to the timestamp at which the even | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | -| event_set | [HealthStatusType](#tetragon.HealthStatusType) | repeated | | +| event_set | [HealthStatusType](#tetragon-HealthStatusType) | repeated | | - + ### GetHealthStatusResponse @@ -358,14 +358,14 @@ For an aggregated response, this field to set to the timestamp at which the even | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | -| health_status | [HealthStatus](#tetragon.HealthStatus) | repeated | | +| health_status | [HealthStatus](#tetragon-HealthStatus) | repeated | | - + ### GetSensorConfigRequest @@ -381,7 +381,7 @@ For an aggregated response, this field to set to the timestamp at which the even - + ### GetSensorConfigResponse @@ -396,7 +396,7 @@ For an aggregated response, this field to set to the timestamp at which the even - + ### GetStackTraceTreeRequest @@ -411,7 +411,7 @@ For an aggregated response, this field to set to the timestamp at which the even - + ### GetStackTraceTreeResponse @@ -419,14 +419,14 @@ For an aggregated response, this field to set to the timestamp at which the even | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | -| root | [StackTraceNode](#tetragon.StackTraceNode) | | | +| root | [StackTraceNode](#tetragon-StackTraceNode) | | | - + ### GetVersionRequest @@ -436,7 +436,7 @@ For an aggregated response, this field to set to the timestamp at which the even - + ### GetVersionResponse @@ -451,7 +451,7 @@ For an aggregated response, this field to set to the timestamp at which the even - + ### HealthStatus @@ -459,8 +459,8 @@ For an aggregated response, this field to set to the timestamp at which the even | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | -| event | [HealthStatusType](#tetragon.HealthStatusType) | | | -| status | [HealthStatusResult](#tetragon.HealthStatusResult) | | | +| event | [HealthStatusType](#tetragon-HealthStatusType) | | | +| status | [HealthStatusResult](#tetragon-HealthStatusResult) | | | | details | [string](#string) | | | @@ -468,7 +468,7 @@ For an aggregated response, this field to set to the timestamp at which the even - + ### Image @@ -484,7 +484,7 @@ For an aggregated response, this field to set to the timestamp at which the even - + ### KprobeArgument @@ -494,21 +494,21 @@ For an aggregated response, this field to set to the timestamp at which the even | ----- | ---- | ----- | ----------- | | string_arg | [string](#string) | | | | int_arg | [int32](#int32) | | | -| skb_arg | [KprobeSkb](#tetragon.KprobeSkb) | | | +| skb_arg | [KprobeSkb](#tetragon-KprobeSkb) | | | | size_arg | [uint64](#uint64) | | | | bytes_arg | [bytes](#bytes) | | | -| path_arg | [KprobePath](#tetragon.KprobePath) | | | -| file_arg | [KprobeFile](#tetragon.KprobeFile) | | | -| truncated_bytes_arg | [KprobeTruncatedBytes](#tetragon.KprobeTruncatedBytes) | | | -| sock_arg | [KprobeSock](#tetragon.KprobeSock) | | | -| cred_arg | [KprobeCred](#tetragon.KprobeCred) | | | +| path_arg | [KprobePath](#tetragon-KprobePath) | | | +| file_arg | [KprobeFile](#tetragon-KprobeFile) | | | +| truncated_bytes_arg | [KprobeTruncatedBytes](#tetragon-KprobeTruncatedBytes) | | | +| sock_arg | [KprobeSock](#tetragon-KprobeSock) | | | +| cred_arg | [KprobeCred](#tetragon-KprobeCred) | | | - + ### KprobeCred @@ -516,16 +516,16 @@ For an aggregated response, this field to set to the timestamp at which the even | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | -| permitted | [CapabilitiesType](#tetragon.CapabilitiesType) | repeated | | -| effective | [CapabilitiesType](#tetragon.CapabilitiesType) | repeated | | -| inheritable | [CapabilitiesType](#tetragon.CapabilitiesType) | repeated | | +| permitted | [CapabilitiesType](#tetragon-CapabilitiesType) | repeated | | +| effective | [CapabilitiesType](#tetragon-CapabilitiesType) | repeated | | +| inheritable | [CapabilitiesType](#tetragon-CapabilitiesType) | repeated | | - + ### KprobeFile @@ -542,7 +542,7 @@ For an aggregated response, this field to set to the timestamp at which the even - + ### KprobePath @@ -559,7 +559,7 @@ For an aggregated response, this field to set to the timestamp at which the even - + ### KprobeSkb @@ -584,7 +584,7 @@ For an aggregated response, this field to set to the timestamp at which the even - + ### KprobeSock @@ -607,7 +607,7 @@ For an aggregated response, this field to set to the timestamp at which the even - + ### KprobeTruncatedBytes @@ -623,7 +623,7 @@ For an aggregated response, this field to set to the timestamp at which the even - + ### ListSensorsRequest @@ -633,7 +633,7 @@ For an aggregated response, this field to set to the timestamp at which the even - + ### ListSensorsResponse @@ -641,14 +641,14 @@ For an aggregated response, this field to set to the timestamp at which the even | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | -| sensors | [SensorStatus](#tetragon.SensorStatus) | repeated | | +| sensors | [SensorStatus](#tetragon-SensorStatus) | repeated | | - + ### Namespace @@ -664,7 +664,7 @@ For an aggregated response, this field to set to the timestamp at which the even - + ### Namespaces @@ -672,23 +672,23 @@ For an aggregated response, this field to set to the timestamp at which the even | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | -| uts | [Namespace](#tetragon.Namespace) | | | -| ipc | [Namespace](#tetragon.Namespace) | | | -| mnt | [Namespace](#tetragon.Namespace) | | | -| pid | [Namespace](#tetragon.Namespace) | | | -| pid_for_children | [Namespace](#tetragon.Namespace) | | | -| net | [Namespace](#tetragon.Namespace) | | | -| time | [Namespace](#tetragon.Namespace) | | | -| time_for_children | [Namespace](#tetragon.Namespace) | | | -| cgroup | [Namespace](#tetragon.Namespace) | | | -| user | [Namespace](#tetragon.Namespace) | | | +| uts | [Namespace](#tetragon-Namespace) | | | +| ipc | [Namespace](#tetragon-Namespace) | | | +| mnt | [Namespace](#tetragon-Namespace) | | | +| pid | [Namespace](#tetragon-Namespace) | | | +| pid_for_children | [Namespace](#tetragon-Namespace) | | | +| net | [Namespace](#tetragon-Namespace) | | | +| time | [Namespace](#tetragon-Namespace) | | | +| time_for_children | [Namespace](#tetragon-Namespace) | | | +| cgroup | [Namespace](#tetragon-Namespace) | | | +| user | [Namespace](#tetragon-Namespace) | | | - + ### Pod @@ -699,14 +699,14 @@ For an aggregated response, this field to set to the timestamp at which the even | namespace | [string](#string) | | | | name | [string](#string) | | | | labels | [string](#string) | repeated | | -| container | [Container](#tetragon.Container) | | | +| container | [Container](#tetragon-Container) | | | - + ### Process @@ -715,27 +715,27 @@ For an aggregated response, this field to set to the timestamp at which the even | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | | exec_id | [string](#string) | | Exec ID uniquely identifies the process over time across all the nodes in the cluster. | -| pid | [google.protobuf.UInt32Value](#google.protobuf.UInt32Value) | | | -| uid | [google.protobuf.UInt32Value](#google.protobuf.UInt32Value) | | | +| pid | [google.protobuf.UInt32Value](#google-protobuf-UInt32Value) | | | +| uid | [google.protobuf.UInt32Value](#google-protobuf-UInt32Value) | | | | cwd | [string](#string) | | | | binary | [string](#string) | | | | arguments | [string](#string) | | | | flags | [string](#string) | | | -| start_time | [google.protobuf.Timestamp](#google.protobuf.Timestamp) | | | -| auid | [google.protobuf.UInt32Value](#google.protobuf.UInt32Value) | | | -| pod | [Pod](#tetragon.Pod) | | | +| start_time | [google.protobuf.Timestamp](#google-protobuf-Timestamp) | | | +| auid | [google.protobuf.UInt32Value](#google-protobuf-UInt32Value) | | | +| pod | [Pod](#tetragon-Pod) | | | | docker | [string](#string) | | | | parent_exec_id | [string](#string) | | | | refcnt | [uint32](#uint32) | | | -| cap | [Capabilities](#tetragon.Capabilities) | | | -| ns | [Namespaces](#tetragon.Namespaces) | | | +| cap | [Capabilities](#tetragon-Capabilities) | | | +| ns | [Namespaces](#tetragon-Namespaces) | | | - + ### ProcessDns @@ -743,17 +743,17 @@ For an aggregated response, this field to set to the timestamp at which the even | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | -| process | [Process](#tetragon.Process) | | | -| dns | [DnsInfo](#tetragon.DnsInfo) | | | +| process | [Process](#tetragon-Process) | | | +| dns | [DnsInfo](#tetragon-DnsInfo) | | | | destination_names | [string](#string) | repeated | **Deprecated.** deprecated in favor of socket.destination_names. | -| destination_pod | [Pod](#tetragon.Pod) | | | +| destination_pod | [Pod](#tetragon-Pod) | | | - + ### ProcessExec @@ -761,16 +761,16 @@ For an aggregated response, this field to set to the timestamp at which the even | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | -| process | [Process](#tetragon.Process) | | | -| parent | [Process](#tetragon.Process) | | | -| ancestors | [Process](#tetragon.Process) | repeated | Ancestors of the process beyond the immediate parent. | +| process | [Process](#tetragon-Process) | | | +| parent | [Process](#tetragon-Process) | | | +| ancestors | [Process](#tetragon-Process) | repeated | Ancestors of the process beyond the immediate parent. | - + ### ProcessExit @@ -778,8 +778,8 @@ For an aggregated response, this field to set to the timestamp at which the even | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | -| process | [Process](#tetragon.Process) | | | -| parent | [Process](#tetragon.Process) | | | +| process | [Process](#tetragon-Process) | | | +| parent | [Process](#tetragon-Process) | | | | signal | [string](#string) | | | | status | [uint32](#uint32) | | | @@ -788,7 +788,7 @@ For an aggregated response, this field to set to the timestamp at which the even - + ### ProcessKprobe @@ -796,19 +796,19 @@ For an aggregated response, this field to set to the timestamp at which the even | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | -| process | [Process](#tetragon.Process) | | | -| parent | [Process](#tetragon.Process) | | | +| process | [Process](#tetragon-Process) | | | +| parent | [Process](#tetragon-Process) | | | | function_name | [string](#string) | | | -| args | [KprobeArgument](#tetragon.KprobeArgument) | repeated | | -| return | [KprobeArgument](#tetragon.KprobeArgument) | | | -| action | [KprobeAction](#tetragon.KprobeAction) | | | +| args | [KprobeArgument](#tetragon-KprobeArgument) | repeated | | +| return | [KprobeArgument](#tetragon-KprobeArgument) | | | +| action | [KprobeAction](#tetragon-KprobeAction) | | | - + ### ProcessTracepoint @@ -816,18 +816,18 @@ For an aggregated response, this field to set to the timestamp at which the even | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | -| process | [Process](#tetragon.Process) | | | -| parent | [Process](#tetragon.Process) | | | +| process | [Process](#tetragon-Process) | | | +| parent | [Process](#tetragon-Process) | | | | subsys | [string](#string) | | | | event | [string](#string) | | | -| args | [KprobeArgument](#tetragon.KprobeArgument) | repeated | TODO: once we implement all we want, rename KprobeArgument to GenericArgument | +| args | [KprobeArgument](#tetragon-KprobeArgument) | repeated | TODO: once we implement all we want, rename KprobeArgument to GenericArgument | - + ### RemoveSensorRequest @@ -842,7 +842,7 @@ For an aggregated response, this field to set to the timestamp at which the even - + ### RemoveSensorResponse @@ -852,7 +852,7 @@ For an aggregated response, this field to set to the timestamp at which the even - + ### SensorStatus @@ -868,7 +868,7 @@ For an aggregated response, this field to set to the timestamp at which the even - + ### SetSensorConfigRequest @@ -885,7 +885,7 @@ For an aggregated response, this field to set to the timestamp at which the even - + ### SetSensorConfigResponse @@ -895,7 +895,7 @@ For an aggregated response, this field to set to the timestamp at which the even - + ### StackAddress @@ -911,7 +911,7 @@ For an aggregated response, this field to set to the timestamp at which the even - + ### StackTrace @@ -919,14 +919,14 @@ For an aggregated response, this field to set to the timestamp at which the even | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | -| addresses | [StackAddress](#tetragon.StackAddress) | repeated | | +| addresses | [StackAddress](#tetragon-StackAddress) | repeated | | - + ### StackTraceLabel @@ -942,7 +942,7 @@ For an aggregated response, this field to set to the timestamp at which the even - + ### StackTraceNode @@ -950,17 +950,17 @@ For an aggregated response, this field to set to the timestamp at which the even | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | -| address | [StackAddress](#tetragon.StackAddress) | | | +| address | [StackAddress](#tetragon-StackAddress) | | | | count | [uint64](#uint64) | | | -| labels | [StackTraceLabel](#tetragon.StackTraceLabel) | repeated | | -| children | [StackTraceNode](#tetragon.StackTraceNode) | repeated | | +| labels | [StackTraceLabel](#tetragon-StackTraceLabel) | repeated | | +| children | [StackTraceNode](#tetragon-StackTraceNode) | repeated | | - + ### Test @@ -980,7 +980,7 @@ For an aggregated response, this field to set to the timestamp at which the even - + ### CapabilitiesType @@ -1041,7 +1041,7 @@ CAP_PERFMON and CAP_BPF are required to load tracing programs. CAP_NET_ADMIN and - + ### EventType EventType constants are based on the ones from pkg/api/client @@ -1058,7 +1058,7 @@ EventType constants are based on the ones from pkg/api/client - + ### HealthStatusResult @@ -1072,7 +1072,7 @@ EventType constants are based on the ones from pkg/api/client - + ### HealthStatusType @@ -1084,7 +1084,7 @@ EventType constants are based on the ones from pkg/api/client - + ### KprobeAction @@ -1105,24 +1105,24 @@ EventType constants are based on the ones from pkg/api/client - + ### FineGuidanceSensors | Method Name | Request Type | Response Type | Description | | ----------- | ------------ | ------------- | ------------| -| GetEvents | [GetEventsRequest](#tetragon.GetEventsRequest) | [GetEventsResponse](#tetragon.GetEventsResponse) stream | | -| GetHealth | [GetHealthStatusRequest](#tetragon.GetHealthStatusRequest) | [GetHealthStatusResponse](#tetragon.GetHealthStatusResponse) | | -| AddTracingPolicy | [AddTracingPolicyRequest](#tetragon.AddTracingPolicyRequest) | [AddTracingPolicyResponse](#tetragon.AddTracingPolicyResponse) | | -| RemoveSensor | [RemoveSensorRequest](#tetragon.RemoveSensorRequest) | [RemoveSensorResponse](#tetragon.RemoveSensorResponse) | | -| ListSensors | [ListSensorsRequest](#tetragon.ListSensorsRequest) | [ListSensorsResponse](#tetragon.ListSensorsResponse) | | -| EnableSensor | [EnableSensorRequest](#tetragon.EnableSensorRequest) | [EnableSensorResponse](#tetragon.EnableSensorResponse) | | -| DisableSensor | [DisableSensorRequest](#tetragon.DisableSensorRequest) | [DisableSensorResponse](#tetragon.DisableSensorResponse) | | -| SetSensorConfig | [SetSensorConfigRequest](#tetragon.SetSensorConfigRequest) | [SetSensorConfigResponse](#tetragon.SetSensorConfigResponse) | | -| GetSensorConfig | [GetSensorConfigRequest](#tetragon.GetSensorConfigRequest) | [GetSensorConfigResponse](#tetragon.GetSensorConfigResponse) | | -| GetStackTraceTree | [GetStackTraceTreeRequest](#tetragon.GetStackTraceTreeRequest) | [GetStackTraceTreeResponse](#tetragon.GetStackTraceTreeResponse) | | -| GetVersion | [GetVersionRequest](#tetragon.GetVersionRequest) | [GetVersionResponse](#tetragon.GetVersionResponse) | | +| GetEvents | [GetEventsRequest](#tetragon-GetEventsRequest) | [GetEventsResponse](#tetragon-GetEventsResponse) stream | | +| GetHealth | [GetHealthStatusRequest](#tetragon-GetHealthStatusRequest) | [GetHealthStatusResponse](#tetragon-GetHealthStatusResponse) | | +| AddTracingPolicy | [AddTracingPolicyRequest](#tetragon-AddTracingPolicyRequest) | [AddTracingPolicyResponse](#tetragon-AddTracingPolicyResponse) | | +| RemoveSensor | [RemoveSensorRequest](#tetragon-RemoveSensorRequest) | [RemoveSensorResponse](#tetragon-RemoveSensorResponse) | | +| ListSensors | [ListSensorsRequest](#tetragon-ListSensorsRequest) | [ListSensorsResponse](#tetragon-ListSensorsResponse) | | +| EnableSensor | [EnableSensorRequest](#tetragon-EnableSensorRequest) | [EnableSensorResponse](#tetragon-EnableSensorResponse) | | +| DisableSensor | [DisableSensorRequest](#tetragon-DisableSensorRequest) | [DisableSensorResponse](#tetragon-DisableSensorResponse) | | +| SetSensorConfig | [SetSensorConfigRequest](#tetragon-SetSensorConfigRequest) | [SetSensorConfigResponse](#tetragon-SetSensorConfigResponse) | | +| GetSensorConfig | [GetSensorConfigRequest](#tetragon-GetSensorConfigRequest) | [GetSensorConfigResponse](#tetragon-GetSensorConfigResponse) | | +| GetStackTraceTree | [GetStackTraceTreeRequest](#tetragon-GetStackTraceTreeRequest) | [GetStackTraceTreeResponse](#tetragon-GetStackTraceTreeResponse) | | +| GetVersion | [GetVersionRequest](#tetragon-GetVersionRequest) | [GetVersionResponse](#tetragon-GetVersionResponse) | | diff --git a/api/v1/tetragon/tetragon.pb.go b/api/v1/tetragon/tetragon.pb.go index 1a48f4db269..e8ae32e4020 100644 --- a/api/v1/tetragon/tetragon.pb.go +++ b/api/v1/tetragon/tetragon.pb.go @@ -14,8 +14,8 @@ // Code generated by protoc-gen-go. DO NOT EDIT. // versions: -// protoc-gen-go v1.27.1 -// protoc v3.18.1 +// protoc-gen-go v1.28.0 +// protoc v3.20.1 // source: tetragon/tetragon.proto package tetragon diff --git a/api/v1/tetragon/tetragon_grpc.pb.go b/api/v1/tetragon/tetragon_grpc.pb.go index 2fc43e2526a..ef1a8a25cee 100644 --- a/api/v1/tetragon/tetragon_grpc.pb.go +++ b/api/v1/tetragon/tetragon_grpc.pb.go @@ -1,4 +1,8 @@ // Code generated by protoc-gen-go-grpc. DO NOT EDIT. +// versions: +// - protoc-gen-go-grpc v1.2.0 +// - protoc v3.20.1 +// source: tetragon/tetragon.proto package tetragon