From 1fefdbb2c26128c18e339a78866d4b756548b6c2 Mon Sep 17 00:00:00 2001 From: Michael Katsoulis Date: Tue, 10 Dec 2024 11:37:49 +0200 Subject: [PATCH 1/8] Add support for podman metrics in docker module (#41889) * Add support for podman metrics --- metricbeat/docs/modules/docker.asciidoc | 9 +++++ metricbeat/metricbeat.reference.yml | 3 ++ .../module/docker/_meta/config.reference.yml | 3 ++ metricbeat/module/docker/_meta/config.yml | 3 ++ metricbeat/module/docker/_meta/docs.asciidoc | 6 +++ metricbeat/module/docker/config.go | 8 ++-- metricbeat/module/docker/cpu/cpu.go | 4 +- metricbeat/module/docker/diskio/diskio.go | 2 +- metricbeat/module/docker/docker.go | 40 +++++++++++++++---- metricbeat/module/docker/memory/memory.go | 4 +- metricbeat/module/docker/network/network.go | 2 +- .../docker/network_summary/network_summary.go | 2 +- metricbeat/modules.d/docker.yml.disabled | 3 ++ x-pack/metricbeat/metricbeat.reference.yml | 3 ++ 14 files changed, 76 insertions(+), 16 deletions(-) diff --git a/metricbeat/docs/modules/docker.asciidoc b/metricbeat/docs/modules/docker.asciidoc index cd5e2a207a8..a8ae9cbf488 100644 --- a/metricbeat/docs/modules/docker.asciidoc +++ b/metricbeat/docs/modules/docker.asciidoc @@ -22,6 +22,9 @@ The Docker module is currently tested on Linux and Mac with the community edition engine, versions 1.11 and 17.09.0-ce. It is not tested on Windows, but it should also work there. +The Docker module supports collection of metrics from Podman's Docker-compatible API. +It has been tested on Linux and Mac with Podman Rest API v2.0.0 and above. + [float] === Module-specific configuration notes @@ -30,6 +33,9 @@ It is strongly recommended that you run Docker metricsets with a Docker API already takes up to 2 seconds. Specifying less than 3 seconds will result in requests that timeout, and no data will be reported for those requests. +In the case of Podman, the configuration parameter `podman` should be set to `true`. +This enables streaming of container stats output, which allows for more accurate +CPU percentage calculations when using Podman. :edit_url: @@ -62,6 +68,9 @@ metricbeat.modules: # If set to true, replace dots in labels with `_`. #labels.dedot: false + # Docker module supports metrics collection from podman's docker compatible API. In case of podman set to true. + # podman: false + # Skip metrics for certain device major numbers in docker/diskio. # Necessary on systems with software RAID, device mappers, # or other configurations where virtual disks will sum metrics from other disks. diff --git a/metricbeat/metricbeat.reference.yml b/metricbeat/metricbeat.reference.yml index 0a05e0c6008..f1412be4b6f 100644 --- a/metricbeat/metricbeat.reference.yml +++ b/metricbeat/metricbeat.reference.yml @@ -268,6 +268,9 @@ metricbeat.modules: # If set to true, replace dots in labels with `_`. #labels.dedot: false + # Docker module supports metrics collection from podman's docker compatible API. In case of podman set to true. + # podman: false + # Skip metrics for certain device major numbers in docker/diskio. # Necessary on systems with software RAID, device mappers, # or other configurations where virtual disks will sum metrics from other disks. diff --git a/metricbeat/module/docker/_meta/config.reference.yml b/metricbeat/module/docker/_meta/config.reference.yml index 8d11201983c..184d6592bf1 100644 --- a/metricbeat/module/docker/_meta/config.reference.yml +++ b/metricbeat/module/docker/_meta/config.reference.yml @@ -17,6 +17,9 @@ # If set to true, replace dots in labels with `_`. #labels.dedot: false + # Docker module supports metrics collection from podman's docker compatible API. In case of podman set to true. + # podman: false + # Skip metrics for certain device major numbers in docker/diskio. # Necessary on systems with software RAID, device mappers, # or other configurations where virtual disks will sum metrics from other disks. diff --git a/metricbeat/module/docker/_meta/config.yml b/metricbeat/module/docker/_meta/config.yml index da3c1e02a06..a7b9b9196fc 100644 --- a/metricbeat/module/docker/_meta/config.yml +++ b/metricbeat/module/docker/_meta/config.yml @@ -15,6 +15,9 @@ # If set to true, replace dots in labels with `_`. #labels.dedot: false + # Docker module supports metrics collection from podman's Docker-compatible API. In case of podman set to true. + # podman: false + # Skip metrics for certain device major numbers in docker/diskio. # Necessary on systems with software RAID, device mappers, # or other configurations where virtual disks will sum metrics from other disks. diff --git a/metricbeat/module/docker/_meta/docs.asciidoc b/metricbeat/module/docker/_meta/docs.asciidoc index e1d5437572a..ca2da0ea26d 100644 --- a/metricbeat/module/docker/_meta/docs.asciidoc +++ b/metricbeat/module/docker/_meta/docs.asciidoc @@ -11,6 +11,9 @@ The Docker module is currently tested on Linux and Mac with the community edition engine, versions 1.11 and 17.09.0-ce. It is not tested on Windows, but it should also work there. +The Docker module supports collection of metrics from Podman's Docker-compatible API. +It has been tested on Linux and Mac with Podman Rest API v2.0.0 and above. + [float] === Module-specific configuration notes @@ -19,3 +22,6 @@ It is strongly recommended that you run Docker metricsets with a Docker API already takes up to 2 seconds. Specifying less than 3 seconds will result in requests that timeout, and no data will be reported for those requests. +In the case of Podman, the configuration parameter `podman` should be set to `true`. +This enables streaming of container stats output, which allows for more accurate +CPU percentage calculations when using Podman. diff --git a/metricbeat/module/docker/config.go b/metricbeat/module/docker/config.go index 40698cb0baf..b9bee9b35e9 100644 --- a/metricbeat/module/docker/config.go +++ b/metricbeat/module/docker/config.go @@ -19,14 +19,16 @@ package docker // Config contains the config needed for the docker type Config struct { - TLS *TLSConfig `config:"ssl"` - DeDot bool `config:"labels.dedot"` + TLS *TLSConfig `config:"ssl"` + DeDot bool `config:"labels.dedot"` + Podman bool `config:"podman"` } // DefaultConfig returns default module config func DefaultConfig() Config { return Config{ - DeDot: true, + DeDot: true, + Podman: false, } } diff --git a/metricbeat/module/docker/cpu/cpu.go b/metricbeat/module/docker/cpu/cpu.go index a29ee8a00cc..6869dd30a46 100644 --- a/metricbeat/module/docker/cpu/cpu.go +++ b/metricbeat/module/docker/cpu/cpu.go @@ -40,6 +40,7 @@ type MetricSet struct { cpuService *CPUService dockerClient *client.Client dedot bool + podman bool } // New creates a new instance of the docker cpu MetricSet. @@ -68,12 +69,13 @@ func New(base mb.BaseMetricSet) (mb.MetricSet, error) { dockerClient: client, cpuService: &CPUService{Cores: cpuConfig.Cores}, dedot: config.DeDot, + podman: config.Podman, }, nil } // Fetch returns a list of docker CPU stats. func (m *MetricSet) Fetch(r mb.ReporterV2) error { - stats, err := docker.FetchStats(m.dockerClient, m.Module().Config().Timeout) + stats, err := docker.FetchStats(m.dockerClient, m.Module().Config().Timeout, m.podman, m.Logger()) if err != nil { return fmt.Errorf("failed to get docker stats: %w", err) } diff --git a/metricbeat/module/docker/diskio/diskio.go b/metricbeat/module/docker/diskio/diskio.go index df5a0f2dff5..a59de2d5268 100644 --- a/metricbeat/module/docker/diskio/diskio.go +++ b/metricbeat/module/docker/diskio/diskio.go @@ -89,7 +89,7 @@ func New(base mb.BaseMetricSet) (mb.MetricSet, error) { // Fetch creates list of events with diskio stats for all containers. func (m *MetricSet) Fetch(r mb.ReporterV2) error { - stats, err := docker.FetchStats(m.dockerClient, m.Module().Config().Timeout) + stats, err := docker.FetchStats(m.dockerClient, m.Module().Config().Timeout, false, m.Logger()) if err != nil { return fmt.Errorf("failed to get docker stats: %w", err) } diff --git a/metricbeat/module/docker/docker.go b/metricbeat/module/docker/docker.go index 2020df91975..d4595ef8e5e 100644 --- a/metricbeat/module/docker/docker.go +++ b/metricbeat/module/docker/docker.go @@ -34,6 +34,7 @@ import ( "github.com/elastic/beats/v7/metricbeat/mb" "github.com/elastic/beats/v7/metricbeat/mb/parse" "github.com/elastic/elastic-agent-autodiscover/docker" + "github.com/elastic/elastic-agent-libs/logp" ) // HostParser is a TCP host parser function for docker tcp host addresses @@ -91,7 +92,7 @@ func NewDockerClient(endpoint string, config Config) (*client.Client, error) { } // FetchStats returns a list of running containers with all related stats inside -func FetchStats(client *client.Client, timeout time.Duration) ([]Stat, error) { +func FetchStats(client *client.Client, timeout time.Duration, stream bool, logger *logp.Logger) ([]Stat, error) { ctx, cancel := context.WithTimeout(context.Background(), timeout) defer cancel() containers, err := client.ContainerList(ctx, container.ListOptions{}) @@ -108,7 +109,7 @@ func FetchStats(client *client.Client, timeout time.Duration) ([]Stat, error) { for _, container := range containers { go func(container types.Container) { defer wg.Done() - statsQueue <- exportContainerStats(ctx, client, &container) + statsQueue <- exportContainerStats(ctx, client, &container, stream, logger) }(container) } @@ -133,18 +134,41 @@ func FetchStats(client *client.Client, timeout time.Duration) ([]Stat, error) { // This is currently very inefficient as docker calculates the average for each request, // means each request will take at least 2s: https://github.com/docker/docker/blob/master/cli/command/container/stats_helpers.go#L148 // Getting all stats at once is implemented here: https://github.com/docker/docker/pull/25361 -func exportContainerStats(ctx context.Context, client *client.Client, container *types.Container) Stat { +// In case stream is true, we use get a stream of results for container stats. From the stream we keep the second result. +// This is needed for podman use case where in case stream is false, no precpu stats are returned. The precpu stats +// are required for the cpu percentage calculation. We keep the second result as in the first result, the stats are not correct. +func exportContainerStats(ctx context.Context, client *client.Client, container *types.Container, stream bool, logger *logp.Logger) Stat { var event Stat event.Container = container - - containerStats, err := client.ContainerStats(ctx, container.ID, false) + containerStats, err := client.ContainerStats(ctx, container.ID, stream) if err != nil { + logger.Debugf("Failed fetching container stats: %v", err) return event } - defer containerStats.Body.Close() - decoder := json.NewDecoder(containerStats.Body) - decoder.Decode(&event.Stats) + // JSON decoder + decoder := json.NewDecoder(containerStats.Body) + if !stream { + if err := decoder.Decode(&event.Stats); err != nil { + logger.Debugf("Failed decoding event: %v", err) + return event + } + } else { + // handle stream. Take the second result. + count := 0 + for decoder.More() { + if err := decoder.Decode(&event.Stats); err != nil { + logger.Debugf("Failed decoding event: %v", err) + return event + } + + count++ + // Exit after the second result + if count == 2 { + break + } + } + } return event } diff --git a/metricbeat/module/docker/memory/memory.go b/metricbeat/module/docker/memory/memory.go index 140383de833..5c90c09d39c 100644 --- a/metricbeat/module/docker/memory/memory.go +++ b/metricbeat/module/docker/memory/memory.go @@ -43,6 +43,7 @@ type MetricSet struct { memoryService *MemoryService dockerClient *client.Client dedot bool + podman bool logger *logp.Logger } @@ -64,13 +65,14 @@ func New(base mb.BaseMetricSet) (mb.MetricSet, error) { memoryService: &MemoryService{}, dockerClient: dockerClient, dedot: config.DeDot, + podman: config.Podman, logger: logger, }, nil } // Fetch creates a list of memory events for each container. func (m *MetricSet) Fetch(r mb.ReporterV2) error { - stats, err := docker.FetchStats(m.dockerClient, m.Module().Config().Timeout) + stats, err := docker.FetchStats(m.dockerClient, m.Module().Config().Timeout, m.podman, m.Logger()) if err != nil { return fmt.Errorf("failed to get docker stats: %w", err) } diff --git a/metricbeat/module/docker/network/network.go b/metricbeat/module/docker/network/network.go index 8a70fd12446..34487aa4983 100644 --- a/metricbeat/module/docker/network/network.go +++ b/metricbeat/module/docker/network/network.go @@ -66,7 +66,7 @@ func New(base mb.BaseMetricSet) (mb.MetricSet, error) { // Fetch methods creates a list of network events for each container. func (m *MetricSet) Fetch(r mb.ReporterV2) error { - stats, err := docker.FetchStats(m.dockerClient, m.Module().Config().Timeout) + stats, err := docker.FetchStats(m.dockerClient, m.Module().Config().Timeout, false, m.Logger()) if err != nil { return fmt.Errorf("failed to get docker stats: %w", err) } diff --git a/metricbeat/module/docker/network_summary/network_summary.go b/metricbeat/module/docker/network_summary/network_summary.go index 9753b449add..9052e38580b 100644 --- a/metricbeat/module/docker/network_summary/network_summary.go +++ b/metricbeat/module/docker/network_summary/network_summary.go @@ -84,7 +84,7 @@ func New(base mb.BaseMetricSet) (mb.MetricSet, error) { // of an error set the Error field of mb.Event or simply call report.Error(). func (m *MetricSet) Fetch(ctx context.Context, report mb.ReporterV2) error { - stats, err := docker.FetchStats(m.dockerClient, m.Module().Config().Timeout) + stats, err := docker.FetchStats(m.dockerClient, m.Module().Config().Timeout, false, m.Logger()) if err != nil { return fmt.Errorf("failed to get docker stats: %w", err) } diff --git a/metricbeat/modules.d/docker.yml.disabled b/metricbeat/modules.d/docker.yml.disabled index 88af5d21288..726c535af1a 100644 --- a/metricbeat/modules.d/docker.yml.disabled +++ b/metricbeat/modules.d/docker.yml.disabled @@ -18,6 +18,9 @@ # If set to true, replace dots in labels with `_`. #labels.dedot: false + # Docker module supports metrics collection from podman's Docker-compatible API. In case of podman set to true. + # podman: false + # Skip metrics for certain device major numbers in docker/diskio. # Necessary on systems with software RAID, device mappers, # or other configurations where virtual disks will sum metrics from other disks. diff --git a/x-pack/metricbeat/metricbeat.reference.yml b/x-pack/metricbeat/metricbeat.reference.yml index 8d3949ef666..8c4250caece 100644 --- a/x-pack/metricbeat/metricbeat.reference.yml +++ b/x-pack/metricbeat/metricbeat.reference.yml @@ -521,6 +521,9 @@ metricbeat.modules: # If set to true, replace dots in labels with `_`. #labels.dedot: false + # Docker module supports metrics collection from podman's docker compatible API. In case of podman set to true. + # podman: false + # Skip metrics for certain device major numbers in docker/diskio. # Necessary on systems with software RAID, device mappers, # or other configurations where virtual disks will sum metrics from other disks. From dbeb9cda93620f8c28f24e4b97b3033db93a2f7f Mon Sep 17 00:00:00 2001 From: Mauri de Souza Meneguzzo Date: Tue, 10 Dec 2024 09:09:22 -0300 Subject: [PATCH 2/8] otelconsumer: remove temporary handling of entity too large (#41911) This code was initially added in #41523 because of a limitation from the elasticsearch exporter. The elasticsearch exporter has been updated to enforce flush::max_bytes for the batcher extension and will automatically split the batch if it exceeds the limit. This error is now fixed in the collector v0.115.0. See https://github.com/open-telemetry/opentelemetry-collector-contrib/pull/36396. --- libbeat/outputs/otelconsumer/otelconsumer.go | 25 ----------------- .../outputs/otelconsumer/otelconsumer_test.go | 27 ------------------- 2 files changed, 52 deletions(-) diff --git a/libbeat/outputs/otelconsumer/otelconsumer.go b/libbeat/outputs/otelconsumer/otelconsumer.go index ca5da5308e5..7b2f6fe93e5 100644 --- a/libbeat/outputs/otelconsumer/otelconsumer.go +++ b/libbeat/outputs/otelconsumer/otelconsumer.go @@ -20,7 +20,6 @@ package otelconsumer import ( "context" "fmt" - "strings" "time" "github.com/elastic/beats/v7/libbeat/beat" @@ -103,30 +102,6 @@ func (out *otelConsumer) logsPublish(ctx context.Context, batch publisher.Batch) err := out.logsConsumer.ConsumeLogs(ctx, pLogs) if err != nil { - // If the batch is too large, the elasticsearchexporter will - // return a 413 error. - // - // At the moment, the exporter does not support batch splitting - // on error so we do it here. - // - // See https://github.com/open-telemetry/opentelemetry-collector-contrib/issues/36163. - if strings.Contains(err.Error(), "Request Entity Too Large") { - // Try and split the batch into smaller batches and retry - if batch.SplitRetry() { - st.BatchSplit() - st.RetryableErrors(len(events)) - } else { - // If the batch could not be split, there is no option left but - // to drop it and log the error state. - batch.Drop() - st.PermanentErrors(len(events)) - out.log.Errorf("the batch is too large to be sent: %v", err) - } - - // Don't propagate the error, the batch was split and retried. - return nil - } - // Permanent errors shouldn't be retried. This tipically means // the data cannot be serialized by the exporter that is attached // to the pipeline or when the destination refuses the data because diff --git a/libbeat/outputs/otelconsumer/otelconsumer_test.go b/libbeat/outputs/otelconsumer/otelconsumer_test.go index 2751ce7f721..6a197d806c1 100644 --- a/libbeat/outputs/otelconsumer/otelconsumer_test.go +++ b/libbeat/outputs/otelconsumer/otelconsumer_test.go @@ -90,33 +90,6 @@ func TestPublish(t *testing.T) { assert.Equal(t, outest.BatchRetry, batch.Signals[0].Tag) }) - t.Run("split batch on entity too large error", func(t *testing.T) { - batch := outest.NewBatch(event1, event2, event3) - - otelConsumer := makeOtelConsumer(t, func(ctx context.Context, ld plog.Logs) error { - return errors.New("Request Entity Too Large") - }) - - err := otelConsumer.Publish(ctx, batch) - assert.NoError(t, err) - assert.Len(t, batch.Signals, 1) - assert.Equal(t, outest.BatchSplitRetry, batch.Signals[0].Tag) - }) - - t.Run("drop batch if can't split on entity too large error", func(t *testing.T) { - batch := outest.NewBatch(event1) - - otelConsumer := makeOtelConsumer(t, func(ctx context.Context, ld plog.Logs) error { - return errors.New("Request Entity Too Large") - }) - - err := otelConsumer.Publish(ctx, batch) - assert.NoError(t, err) - assert.Len(t, batch.Signals, 2) - assert.Equal(t, outest.BatchSplitRetry, batch.Signals[0].Tag) - assert.Equal(t, outest.BatchDrop, batch.Signals[1].Tag) - }) - t.Run("drop batch on permanent consumer error", func(t *testing.T) { batch := outest.NewBatch(event1, event2, event3) From 3537486e3be55e89f6115d0bae762b93118116b6 Mon Sep 17 00:00:00 2001 From: David Kilfoyle <41695641+kilfoyle@users.noreply.github.com> Date: Tue, 10 Dec 2024 10:21:55 -0500 Subject: [PATCH 3/8] Add breaking change for Filebeat removed 'docker' input (#41721) --- CHANGELOG.asciidoc | 1 + 1 file changed, 1 insertion(+) diff --git a/CHANGELOG.asciidoc b/CHANGELOG.asciidoc index 21a0639b1e6..7af434990cf 100644 --- a/CHANGELOG.asciidoc +++ b/CHANGELOG.asciidoc @@ -2931,6 +2931,7 @@ https://github.com/elastic/beats/compare/v7.17.0\...v8.0.0[View commits] - Add `while_pattern` type to multiline reader. {pull}19662[19662] - auditd dataset: Use `process.args` to store program arguments instead of `auditd.log.aNNN` fields. {pull}29601[29601] - Remove deprecated old `awscloudwatch` input name. {pull}29844[29844] +- Remove `docker` input. Please use `filestream` input with `container` parser or `container` input. {pull}28817[28817] *Metricbeat* From bde07fad474581d1f4507a8229b186b1c7ab8635 Mon Sep 17 00:00:00 2001 From: Maurizio Branca Date: Tue, 10 Dec 2024 18:18:02 +0100 Subject: [PATCH 4/8] Update CODEOWNERS (#41940) Re-assign the component ownership from `elastic/obs-cloud-monitoring` to `elastic/obs-ds-hosted-services`. The practical reason is the old `elastic/obs-cloud-monitoring` team only includes a subset of the current `elastic/obs-ds-hosted-services`. So if the person who approves a PR is not included in `elastic/obs-cloud-monitoring`, I have to ping an additional person. --- .github/CODEOWNERS | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS index 8f060dc48cf..4b179b38144 100644 --- a/.github/CODEOWNERS +++ b/.github/CODEOWNERS @@ -59,7 +59,7 @@ CHANGELOG* /libbeat/ @elastic/elastic-agent-data-plane /libbeat/docs/processors-list.asciidoc @elastic/ingest-docs /libbeat/management @elastic/elastic-agent-control-plane -/libbeat/processors/add_cloud_metadata @elastic/obs-cloud-monitoring +/libbeat/processors/add_cloud_metadata @elastic/obs-ds-hosted-services /libbeat/processors/add_kubernetes_metadata @elastic/obs-cloudnative-monitoring /libbeat/processors/cache/ @elastic/security-service-integrations /libbeat/processors/community_id/ @elastic/sec-deployment-and-devices @@ -116,10 +116,10 @@ CHANGELOG* /x-pack/filebeat @elastic/elastic-agent-data-plane /x-pack/filebeat/docs/ # Listed without an owner to avoid maintaining doc ownership for each input and module. /x-pack/filebeat/docs/inputs/input-salesforce.asciidoc @elastic/obs-infraobs-integrations -/x-pack/filebeat/input/awscloudwatch/ @elastic/obs-cloud-monitoring -/x-pack/filebeat/input/awss3/ @elastic/obs-cloud-monitoring +/x-pack/filebeat/input/awscloudwatch/ @elastic/obs-ds-hosted-services +/x-pack/filebeat/input/awss3/ @elastic/obs-ds-hosted-services /x-pack/filebeat/input/azureblobstorage/ @elastic/security-service-integrations -/x-pack/filebeat/input/azureeventhub/ @elastic/obs-cloud-monitoring +/x-pack/filebeat/input/azureeventhub/ @elastic/obs-ds-hosted-services /x-pack/filebeat/input/cel/ @elastic/security-service-integrations /x-pack/filebeat/input/cometd/ @elastic/obs-infraobs-integrations /x-pack/filebeat/input/entityanalytics/ @elastic/security-service-integrations @@ -137,9 +137,9 @@ CHANGELOG* /x-pack/filebeat/input/salesforce @elastic/obs-infraobs-integrations /x-pack/filebeat/input/streaming/ @elastic/security-service-integrations /x-pack/filebeat/module/activemq @elastic/obs-infraobs-integrations -/x-pack/filebeat/module/aws @elastic/obs-cloud-monitoring -/x-pack/filebeat/module/awsfargate @elastic/obs-cloud-monitoring -/x-pack/filebeat/module/azure @elastic/obs-cloud-monitoring +/x-pack/filebeat/module/aws @elastic/obs-ds-hosted-services +/x-pack/filebeat/module/awsfargate @elastic/obs-ds-hosted-services +/x-pack/filebeat/module/azure @elastic/obs-ds-hosted-services /x-pack/filebeat/module/barracuda @elastic/security-service-integrations /x-pack/filebeat/module/bluecoat @elastic/sec-deployment-and-devices /x-pack/filebeat/module/cef @elastic/sec-deployment-and-devices From 296b83b6c5c1168b6b09ec3bfca7f4d440628834 Mon Sep 17 00:00:00 2001 From: kruskall <99559985+kruskall@users.noreply.github.com> Date: Tue, 10 Dec 2024 23:08:20 +0100 Subject: [PATCH 5/8] feat: replace custom atomic with sync/atomic (#40132) * feat: replace custom atomic with sync/atomic Go 1.19 added new atomic types. Replace custom atomic types with stdlib atomic package to fully use the race detector, improved lsp hints and support. Use pointers in sniffer struct to prevent copying the atomic struct and cause a race condition. * lint: time.Now().Sub -> time.Since fix golangci-lint issue * Apply suggestions from code review Co-authored-by: Dan Kortschak * refactor: keep Swap usage as is * lint: avoid unnecessary conversion fix golangci-lint issue * fix: update method reference to new atomic types * fix: resolve more compile errors and test failures * lint: fix linter issues * lint: fix linter issues * lint: fix linter issues * lint: fix linter issues * lint: more linting errors * lint: fix linter issues * lint: remove unused import * lint: fix linter issue * lint: fix linter issues * lint: fix linter issues --------- Co-authored-by: Dan Kortschak --- filebeat/channel/outlet.go | 8 +- .../internal/input-logfile/harvester_test.go | 4 +- .../internal/input-logfile/store.go | 8 +- filebeat/input/kafka/input.go | 7 +- filebeat/input/log/input.go | 14 +- filebeat/input/v2/input-cursor/store.go | 10 +- .../v2/input-stateless/stateless_test.go | 14 +- .../inputsource/common/streaming/listener.go | 8 +- heartbeat/monitors/factory_test.go | 8 +- heartbeat/monitors/mocks.go | 14 +- heartbeat/monitors/monitor_test.go | 8 +- heartbeat/scheduler/schedjob.go | 11 +- heartbeat/scheduler/schedjob_test.go | 12 +- libbeat/common/acker/acker.go | 8 +- libbeat/common/atomic/atomic.go | 94 ------ libbeat/common/atomic/atomic32.go | 50 ---- libbeat/common/atomic/atomic64.go | 50 ---- libbeat/common/atomic/atomic_test.go | 273 ------------------ libbeat/idxmgmt/index_support.go | 4 +- libbeat/management/agent.go | 8 +- .../elasticsearch/client_proxy_test.go | 18 +- libbeat/outputs/logstash/async.go | 8 +- .../add_process_metadata.go | 4 +- libbeat/processors/cache/cache.go | 4 +- libbeat/processors/dns/dns.go | 6 +- libbeat/processors/ratelimit/rate_limit.go | 6 +- libbeat/processors/ratelimit/token_bucket.go | 17 +- libbeat/processors/syslog/syslog.go | 6 +- libbeat/publisher/pipeline/client.go | 9 +- .../publisher/pipeline/client_worker_test.go | 32 +- libbeat/publisher/pipeline/controller_test.go | 15 +- libbeat/publisher/pipeline/pipeline.go | 3 +- libbeat/publisher/pipeline/pipeline_test.go | 10 +- libbeat/publisher/pipeline/stress/gen.go | 8 +- libbeat/publisher/pipeline/stress/sig.go | 11 +- libbeat/publisher/testing/connector.go | 17 +- libbeat/tests/integration/framework.go | 5 +- metricbeat/mb/module/runner_group_test.go | 25 +- packetbeat/sniffer/sniffer.go | 9 +- winlogbeat/beater/acker.go | 12 +- winlogbeat/sys/wineventlog/renderer_test.go | 10 +- x-pack/filebeat/input/awss3/metrics_test.go | 2 +- .../internal/kvstore/tracker.go | 8 +- .../internal/kvstore/tracker_test.go | 12 +- .../internal/kvstore/transaction.go | 7 +- .../filebeat/input/gcppubsub/pubsub_test.go | 9 +- .../input/netflow/decoder/atomic/bool.go | 30 -- .../input/netflow/decoder/v9/session.go | 6 +- .../browser/synthexec/execmultiplexer.go | 12 +- x-pack/metricbeat/module/cloudfoundry/v1.go | 6 +- 50 files changed, 223 insertions(+), 717 deletions(-) delete mode 100644 libbeat/common/atomic/atomic.go delete mode 100644 libbeat/common/atomic/atomic32.go delete mode 100644 libbeat/common/atomic/atomic64.go delete mode 100644 libbeat/common/atomic/atomic_test.go delete mode 100644 x-pack/filebeat/input/netflow/decoder/atomic/bool.go diff --git a/filebeat/channel/outlet.go b/filebeat/channel/outlet.go index fd5c9b12fc1..25747046396 100644 --- a/filebeat/channel/outlet.go +++ b/filebeat/channel/outlet.go @@ -18,8 +18,9 @@ package channel import ( + "sync/atomic" + "github.com/elastic/beats/v7/libbeat/beat" - "github.com/elastic/beats/v7/libbeat/common/atomic" ) type outlet struct { @@ -31,15 +32,14 @@ type outlet struct { func newOutlet(client beat.Client) *outlet { o := &outlet{ client: client, - isOpen: atomic.MakeBool(true), done: make(chan struct{}), } + o.isOpen.Store(true) return o } func (o *outlet) Close() error { - isOpen := o.isOpen.Swap(false) - if isOpen { + if o.isOpen.Swap(false) { close(o.done) return o.client.Close() } diff --git a/filebeat/input/filestream/internal/input-logfile/harvester_test.go b/filebeat/input/filestream/internal/input-logfile/harvester_test.go index d8800c85996..6f5938e308a 100644 --- a/filebeat/input/filestream/internal/input-logfile/harvester_test.go +++ b/filebeat/input/filestream/internal/input-logfile/harvester_test.go @@ -23,6 +23,7 @@ import ( "fmt" "strings" "sync" + "sync/atomic" "testing" "time" @@ -32,7 +33,6 @@ import ( "github.com/elastic/beats/v7/filebeat/input/filestream/internal/task" input "github.com/elastic/beats/v7/filebeat/input/v2" "github.com/elastic/beats/v7/libbeat/beat" - "github.com/elastic/beats/v7/libbeat/common/atomic" "github.com/elastic/beats/v7/libbeat/tests/resources" "github.com/elastic/elastic-agent-libs/logp" ) @@ -128,7 +128,7 @@ func TestDefaultHarvesterGroup(t *testing.T) { t.Run("assert a harvester is only started if harvester limit haven't been reached", func(t *testing.T) { var wg sync.WaitGroup - var harvesterRunningCount atomic.Int + var harvesterRunningCount atomic.Int64 var harvester1Finished, harvester2Finished atomic.Bool done1, done2 := make(chan struct{}), make(chan struct{}) diff --git a/filebeat/input/filestream/internal/input-logfile/store.go b/filebeat/input/filestream/internal/input-logfile/store.go index 024ca5c9bfd..14c7869d087 100644 --- a/filebeat/input/filestream/internal/input-logfile/store.go +++ b/filebeat/input/filestream/internal/input-logfile/store.go @@ -21,9 +21,9 @@ import ( "fmt" "strings" "sync" + "sync/atomic" "time" - "github.com/elastic/beats/v7/libbeat/common/atomic" "github.com/elastic/beats/v7/libbeat/common/cleanup" "github.com/elastic/beats/v7/libbeat/common/transform/typeconv" "github.com/elastic/beats/v7/libbeat/statestore" @@ -461,14 +461,14 @@ func (r *resource) isDeleted() bool { // Retain is used to indicate that 'resource' gets an additional 'owner'. // Owners of an resource can be active inputs or pending update operations // not yet written to disk. -func (r *resource) Retain() { r.pending.Inc() } +func (r *resource) Retain() { r.pending.Add(1) } // Release reduced the owner ship counter of the resource. -func (r *resource) Release() { r.pending.Dec() } +func (r *resource) Release() { r.pending.Add(^uint64(0)) } // UpdatesReleaseN is used to release ownership of N pending update operations. func (r *resource) UpdatesReleaseN(n uint) { - r.pending.Sub(uint64(n)) + r.pending.Add(^uint64(n - 1)) } // Finished returns true if the resource is not in use and if there are no pending updates diff --git a/filebeat/input/kafka/input.go b/filebeat/input/kafka/input.go index 6cc74514bef..3f330587f82 100644 --- a/filebeat/input/kafka/input.go +++ b/filebeat/input/kafka/input.go @@ -25,9 +25,9 @@ import ( "io" "strings" "sync" + "sync/atomic" "time" - "github.com/elastic/beats/v7/libbeat/common/atomic" "github.com/elastic/elastic-agent-libs/mapstr" input "github.com/elastic/beats/v7/filebeat/input/v2" @@ -391,9 +391,10 @@ func (l *listFromFieldReader) Next() (reader.Message, error) { timestamp, kafkaFields := composeEventMetadata(l.claim, l.groupHandler, msg) messages := l.parseMultipleMessages(msg.Value) - neededAcks := atomic.MakeInt(len(messages)) + neededAcks := atomic.Int64{} + neededAcks.Add(int64(len(messages))) ackHandler := func() { - if neededAcks.Dec() == 0 { + if neededAcks.Add(-1) == 0 { l.groupHandler.ack(msg) } } diff --git a/filebeat/input/log/input.go b/filebeat/input/log/input.go index ad93632b372..e2090f6ebb8 100644 --- a/filebeat/input/log/input.go +++ b/filebeat/input/log/input.go @@ -25,6 +25,7 @@ import ( "sort" "strings" "sync" + "sync/atomic" "time" "github.com/gofrs/uuid/v5" @@ -35,7 +36,6 @@ import ( "github.com/elastic/beats/v7/filebeat/input/file" "github.com/elastic/beats/v7/libbeat/beat" "github.com/elastic/beats/v7/libbeat/common" - "github.com/elastic/beats/v7/libbeat/common/atomic" "github.com/elastic/beats/v7/libbeat/common/cfgwarn" "github.com/elastic/beats/v7/libbeat/management/status" conf "github.com/elastic/elastic-agent-libs/config" @@ -737,8 +737,8 @@ func (p *Input) createHarvester(logger *logp.Logger, state file.State, onTermina // startHarvester starts a new harvester with the given offset // In case the HarvesterLimit is reached, an error is returned func (p *Input) startHarvester(logger *logp.Logger, state file.State, offset int64) error { - if p.numHarvesters.Inc() > p.config.HarvesterLimit && p.config.HarvesterLimit > 0 { - p.numHarvesters.Dec() + if p.numHarvesters.Add(1) > p.config.HarvesterLimit && p.config.HarvesterLimit > 0 { + p.numHarvesters.Add(^uint32(0)) harvesterSkipped.Add(1) return errHarvesterLimit } @@ -747,15 +747,15 @@ func (p *Input) startHarvester(logger *logp.Logger, state file.State, offset int state.Offset = offset // Create harvester with state - h, err := p.createHarvester(logger, state, func() { p.numHarvesters.Dec() }) + h, err := p.createHarvester(logger, state, func() { p.numHarvesters.Add(^uint32(0)) }) if err != nil { - p.numHarvesters.Dec() + p.numHarvesters.Add(^uint32(0)) return err } err = h.Setup() if err != nil { - p.numHarvesters.Dec() + p.numHarvesters.Add(^uint32(0)) return fmt.Errorf("error setting up harvester: %w", err) } @@ -765,7 +765,7 @@ func (p *Input) startHarvester(logger *logp.Logger, state file.State, offset int h.SendStateUpdate() if err = p.harvesters.Start(h); err != nil { - p.numHarvesters.Dec() + p.numHarvesters.Add(^uint32(0)) } return err } diff --git a/filebeat/input/v2/input-cursor/store.go b/filebeat/input/v2/input-cursor/store.go index cc755f046ca..a53bc77a79f 100644 --- a/filebeat/input/v2/input-cursor/store.go +++ b/filebeat/input/v2/input-cursor/store.go @@ -20,9 +20,9 @@ package cursor import ( "strings" "sync" + "sync/atomic" "time" - "github.com/elastic/beats/v7/libbeat/common/atomic" "github.com/elastic/beats/v7/libbeat/common/cleanup" "github.com/elastic/beats/v7/libbeat/common/transform/typeconv" "github.com/elastic/beats/v7/libbeat/statestore" @@ -235,14 +235,14 @@ func (r *resource) IsNew() bool { // Retain is used to indicate that 'resource' gets an additional 'owner'. // Owners of an resource can be active inputs or pending update operations // not yet written to disk. -func (r *resource) Retain() { r.pending.Inc() } +func (r *resource) Retain() { r.pending.Add(1) } // Release reduced the owner ship counter of the resource. -func (r *resource) Release() { r.pending.Dec() } +func (r *resource) Release() { r.pending.Add(^uint64(0)) } // UpdatesReleaseN is used to release ownership of N pending update operations. func (r *resource) UpdatesReleaseN(n uint) { - r.pending.Sub(uint64(n)) + r.pending.Add(^uint64(n - 1)) } // Finished returns true if the resource is not in use and if there are no pending updates @@ -290,7 +290,7 @@ func readStates(log *logp.Logger, store *statestore.Store, prefix string) (*stat } err := store.Each(func(key string, dec statestore.ValueDecoder) (bool, error) { - if !strings.HasPrefix(string(key), keyPrefix) { + if !strings.HasPrefix(key, keyPrefix) { return true, nil } diff --git a/filebeat/input/v2/input-stateless/stateless_test.go b/filebeat/input/v2/input-stateless/stateless_test.go index 2febcb7e1b6..731577e76c3 100644 --- a/filebeat/input/v2/input-stateless/stateless_test.go +++ b/filebeat/input/v2/input-stateless/stateless_test.go @@ -22,6 +22,7 @@ import ( "errors" "runtime" "sync" + "sync/atomic" "testing" "github.com/stretchr/testify/require" @@ -29,7 +30,6 @@ import ( v2 "github.com/elastic/beats/v7/filebeat/input/v2" stateless "github.com/elastic/beats/v7/filebeat/input/v2/input-stateless" "github.com/elastic/beats/v7/libbeat/beat" - "github.com/elastic/beats/v7/libbeat/common/atomic" pubtest "github.com/elastic/beats/v7/libbeat/publisher/testing" conf "github.com/elastic/elastic-agent-libs/config" "github.com/elastic/elastic-agent-libs/mapstr" @@ -111,12 +111,12 @@ func TestStateless_Run(t *testing.T) { defer cancel() // connector creates a client the blocks forever until the shutdown signal is received - var publishCalls atomic.Int + var publishCalls atomic.Int64 connector := pubtest.FakeConnector{ ConnectFunc: func(config beat.ClientConfig) (beat.Client, error) { return &pubtest.FakeClient{ PublishFunc: func(event beat.Event) { - publishCalls.Inc() + publishCalls.Add(1) // Unlock Publish once the input has been cancelled <-ctx.Done() }, @@ -141,24 +141,24 @@ func TestStateless_Run(t *testing.T) { // validate require.Equal(t, context.Canceled, err) - require.Equal(t, 1, publishCalls.Load()) + require.Equal(t, int64(1), publishCalls.Load()) }) t.Run("do not start input of pipeline connection fails", func(t *testing.T) { errOpps := errors.New("oops") connector := pubtest.FailingConnector(errOpps) - var run atomic.Int + var run atomic.Int64 input := createConfiguredInput(t, constInputManager(&fakeStatelessInput{ OnRun: func(_ v2.Context, publisher stateless.Publisher) error { - run.Inc() + run.Add(1) return nil }, }), nil) err := input.Run(v2.Context{}, connector) require.True(t, errors.Is(err, errOpps)) - require.Equal(t, 0, run.Load()) + require.Equal(t, int64(0), run.Load()) }) } diff --git a/filebeat/inputsource/common/streaming/listener.go b/filebeat/inputsource/common/streaming/listener.go index ce0f69d030e..5816c1fa81c 100644 --- a/filebeat/inputsource/common/streaming/listener.go +++ b/filebeat/inputsource/common/streaming/listener.go @@ -26,9 +26,9 @@ import ( "net" "strings" "sync" + "sync/atomic" "github.com/elastic/beats/v7/filebeat/inputsource" - "github.com/elastic/beats/v7/libbeat/common/atomic" "github.com/elastic/elastic-agent-libs/logp" "github.com/elastic/go-concert/ctxtool" ) @@ -44,7 +44,7 @@ type Listener struct { wg sync.WaitGroup log *logp.Logger ctx ctxtool.CancelContext - clientsCount atomic.Int + clientsCount atomic.Int64 handlerFactory HandlerFactory listenerFactory ListenerFactory } @@ -190,10 +190,10 @@ func (l *Listener) handleConnection(conn net.Conn) { defer cancel() // Track number of clients. - l.clientsCount.Inc() + l.clientsCount.Add(1) log.Debugw("New client connection", "active_clients", l.clientsCount.Load()) defer func() { - l.clientsCount.Dec() + l.clientsCount.Add(-1) log.Debugw("Client disconnected", "active_clients", l.clientsCount.Load()) }() diff --git a/heartbeat/monitors/factory_test.go b/heartbeat/monitors/factory_test.go index e32ac671c8e..72db7cdf731 100644 --- a/heartbeat/monitors/factory_test.go +++ b/heartbeat/monitors/factory_test.go @@ -236,8 +236,8 @@ func TestDisabledMonitor(t *testing.T) { require.NoError(t, err) require.IsType(t, NoopRunner{}, runner) - require.Equal(t, 0, built.Load()) - require.Equal(t, 0, closed.Load()) + require.Equal(t, int64(0), built.Load()) + require.Equal(t, int64(0), closed.Load()) } } @@ -353,7 +353,7 @@ func TestDuplicateMonitorIDs(t *testing.T) { // Two are counted as built. The bad config is missing a stdfield so it // doesn't complete construction - require.Equal(t, 2, built.Load()) + require.Equal(t, int64(2), built.Load()) // Only 2 closes, because the bad config isn't closed - require.Equal(t, 2, closed.Load()) + require.Equal(t, int64(2), closed.Load()) } diff --git a/heartbeat/monitors/mocks.go b/heartbeat/monitors/mocks.go index 77dee19858a..2c4e5e9d0b5 100644 --- a/heartbeat/monitors/mocks.go +++ b/heartbeat/monitors/mocks.go @@ -21,6 +21,7 @@ import ( "fmt" "regexp" "sync" + "sync/atomic" "testing" "time" @@ -42,7 +43,6 @@ import ( "github.com/elastic/beats/v7/heartbeat/monitors/wrappers/monitorstate" "github.com/elastic/beats/v7/heartbeat/scheduler" "github.com/elastic/beats/v7/libbeat/beat" - "github.com/elastic/beats/v7/libbeat/common/atomic" beatversion "github.com/elastic/beats/v7/libbeat/version" ) @@ -212,17 +212,17 @@ func createMockJob() []jobs.Job { return []jobs.Job{j} } -func mockPluginBuilder() (plugin.PluginFactory, *atomic.Int, *atomic.Int) { +func mockPluginBuilder() (plugin.PluginFactory, *atomic.Int64, *atomic.Int64) { reg := monitoring.NewRegistry() - built := atomic.NewInt(0) - closed := atomic.NewInt(0) + built := &atomic.Int64{} + closed := &atomic.Int64{} return plugin.PluginFactory{ Name: "test", Aliases: []string{"testAlias"}, Make: func(s string, config *config.C) (plugin.Plugin, error) { - built.Inc() + built.Add(1) // Declare a real config block with a required attr so we can see what happens when it doesn't work unpacked := struct { URLs []string `config:"urls" validate:"required"` @@ -230,7 +230,7 @@ func mockPluginBuilder() (plugin.PluginFactory, *atomic.Int, *atomic.Int) { // track all closes, even on error closer := func() error { - closed.Inc() + closed.Add(1) return nil } @@ -248,7 +248,7 @@ func mockPluginBuilder() (plugin.PluginFactory, *atomic.Int, *atomic.Int) { closed } -func mockPluginsReg() (p *plugin.PluginsReg, built *atomic.Int, closed *atomic.Int) { +func mockPluginsReg() (p *plugin.PluginsReg, built *atomic.Int64, closed *atomic.Int64) { reg := plugin.NewPluginsReg() builder, built, closed := mockPluginBuilder() _ = reg.Add(builder) diff --git a/heartbeat/monitors/monitor_test.go b/heartbeat/monitors/monitor_test.go index 0890a1697be..7bb3b5d3fae 100644 --- a/heartbeat/monitors/monitor_test.go +++ b/heartbeat/monitors/monitor_test.go @@ -106,10 +106,10 @@ func testMonitorConfig(t *testing.T, conf *conf.C, eventValidator validator.Vali t.Fatalf("No publishes detected!") } - assert.Equal(t, 1, built.Load()) + assert.Equal(t, int64(1), built.Load()) mon.Stop() - assert.Equal(t, 1, closed.Load()) + assert.Equal(t, int64(1), closed.Load()) assert.Equal(t, true, pcClient.closed) } @@ -129,8 +129,8 @@ func TestCheckInvalidConfig(t *testing.T) { require.Nil(t, m, "For this test to work we need a nil value for the monitor.") // These counters are both zero since this fails at config parse time - require.Equal(t, 0, built.Load()) - require.Equal(t, 0, closed.Load()) + require.Equal(t, int64(0), built.Load()) + require.Equal(t, int64(0), closed.Load()) require.Error(t, checkMonitorConfig(serverMonConf, reg)) } diff --git a/heartbeat/scheduler/schedjob.go b/heartbeat/scheduler/schedjob.go index 2a8172b9564..50f94a895d0 100644 --- a/heartbeat/scheduler/schedjob.go +++ b/heartbeat/scheduler/schedjob.go @@ -20,11 +20,11 @@ package scheduler import ( "context" "sync" + "sync/atomic" "time" "golang.org/x/sync/semaphore" - "github.com/elastic/beats/v7/libbeat/common/atomic" "github.com/elastic/elastic-agent-libs/logp" ) @@ -35,7 +35,7 @@ type schedJob struct { wg *sync.WaitGroup entrypoint TaskFunc jobLimitSem *semaphore.Weighted - activeTasks atomic.Int + activeTasks atomic.Int64 } // runRecursiveJob runs the entry point for a job, blocking until all subtasks are completed. @@ -48,7 +48,6 @@ func newSchedJob(ctx context.Context, s *Scheduler, id string, jobType string, t scheduler: s, jobLimitSem: s.jobLimitSem[jobType], entrypoint: task, - activeTasks: atomic.MakeInt(0), wg: &sync.WaitGroup{}, } } @@ -59,7 +58,7 @@ func newSchedJob(ctx context.Context, s *Scheduler, id string, jobType string, t // The wait group passed into this function expects to already have its count incremented by one. func (sj *schedJob) run() (startedAt time.Time) { sj.wg.Add(1) - sj.activeTasks.Inc() + sj.activeTasks.Add(1) if sj.jobLimitSem != nil { err := sj.jobLimitSem.Acquire(sj.ctx, 1) // Defer release only if acquired @@ -82,7 +81,7 @@ func (sj *schedJob) run() (startedAt time.Time) { // The wait group passed into this function expects to already have its count incremented by one. func (sj *schedJob) runTask(task TaskFunc) time.Time { defer sj.wg.Done() - defer sj.activeTasks.Dec() + defer sj.activeTasks.Add(-1) // The accounting for waiting/active tasks is done using atomics. // Absolute accuracy is not critical here so the gap between modifying waitingTasks and activeJobs is acceptable. @@ -113,7 +112,7 @@ func (sj *schedJob) runTask(task TaskFunc) time.Time { sj.scheduler.stats.activeTasks.Dec() sj.wg.Add(len(continuations)) - sj.activeTasks.Add(len(continuations)) + sj.activeTasks.Add(int64(len(continuations))) for _, cont := range continuations { // Run continuations in parallel, note that these each will acquire their own slots // We can discard the started at times for continuations as those are diff --git a/heartbeat/scheduler/schedjob_test.go b/heartbeat/scheduler/schedjob_test.go index 24e6178e162..f989014f467 100644 --- a/heartbeat/scheduler/schedjob_test.go +++ b/heartbeat/scheduler/schedjob_test.go @@ -20,13 +20,13 @@ package scheduler import ( "context" "sync" + "sync/atomic" "testing" "time" "github.com/stretchr/testify/require" "github.com/elastic/beats/v7/heartbeat/config" - batomic "github.com/elastic/beats/v7/libbeat/common/atomic" "github.com/elastic/elastic-agent-libs/monitoring" ) @@ -72,7 +72,7 @@ func TestSchedJobRun(t *testing.T) { wg := &sync.WaitGroup{} wg.Add(1) - executed := batomic.MakeBool(false) + executed := &atomic.Bool{} tf := func(ctx context.Context) []TaskFunc { executed.Store(true) @@ -102,14 +102,14 @@ func TestRecursiveForkingJob(t *testing.T) { s := Create(1000, monitoring.NewRegistry(), tarawaTime(), map[string]*config.JobLimit{ "atype": {Limit: 1}, }, false) - ran := batomic.NewInt(0) + var ran atomic.Int64 var terminalTf TaskFunc = func(ctx context.Context) []TaskFunc { - ran.Inc() + ran.Add(1) return nil } var forkingTf TaskFunc = func(ctx context.Context) []TaskFunc { - ran.Inc() + ran.Add(1) return []TaskFunc{ terminalTf, terminalTf, terminalTf, } @@ -118,6 +118,6 @@ func TestRecursiveForkingJob(t *testing.T) { sj := newSchedJob(context.Background(), s, "myid", "atype", forkingTf) sj.run() - require.Equal(t, 4, ran.Load()) + require.Equal(t, int64(4), ran.Load()) } diff --git a/libbeat/common/acker/acker.go b/libbeat/common/acker/acker.go index c75aec13564..47c019a576f 100644 --- a/libbeat/common/acker/acker.go +++ b/libbeat/common/acker/acker.go @@ -19,9 +19,9 @@ package acker import ( "sync" + "sync/atomic" "github.com/elastic/beats/v7/libbeat/beat" - "github.com/elastic/beats/v7/libbeat/common/atomic" ) // Nil creates an ACKer that does nothing. @@ -98,7 +98,7 @@ type gapInfo struct { } func (a *trackingACKer) AddEvent(_ beat.Event, published bool) { - a.events.Inc() + a.events.Add(1) if published { a.addPublishedEvent() } else { @@ -148,7 +148,7 @@ func (a *trackingACKer) addDropEvent() { a.lst.Unlock() current.Unlock() - a.events.Dec() + a.events.Add(^uint32(0)) return } @@ -202,7 +202,7 @@ func (a *trackingACKer) ACKEvents(n int) { current.Unlock() } - a.events.Sub(uint32(total)) + a.events.Add(^uint32(total - 1)) a.fn(acked, total) } diff --git a/libbeat/common/atomic/atomic.go b/libbeat/common/atomic/atomic.go deleted file mode 100644 index 09e83614184..00000000000 --- a/libbeat/common/atomic/atomic.go +++ /dev/null @@ -1,94 +0,0 @@ -// Licensed to Elasticsearch B.V. under one or more contributor -// license agreements. See the NOTICE file distributed with -// this work for additional information regarding copyright -// ownership. Elasticsearch B.V. licenses this file to you 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 -// -// http://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. - -// Package atomic provides common primitive types with atomic accessors. -package atomic - -import a "sync/atomic" - -// Bool provides an atomic boolean type. -type Bool struct{ u Uint32 } - -// Int32 provides an atomic int32 type. -type Int32 struct{ value int32 } - -// Int64 provides an atomic int64 type. -type Int64 struct{ value int64 } - -// Uint32 provides an atomic uint32 type. -type Uint32 struct{ value uint32 } - -// Uint64 provides an atomic uint64 type. -type Uint64 struct{ value uint64 } - -func MakeBool(v bool) Bool { return Bool{MakeUint32(encBool(v))} } -func NewBool(v bool) *Bool { return &Bool{MakeUint32(encBool(v))} } -func (b *Bool) Load() bool { return b.u.Load() == 1 } -func (b *Bool) Store(v bool) { b.u.Store(encBool(v)) } -func (b *Bool) Swap(new bool) bool { return b.u.Swap(encBool(new)) == 1 } -func (b *Bool) CAS(old, new bool) bool { return b.u.CAS(encBool(old), encBool(new)) } - -func MakeInt32(v int32) Int32 { return Int32{v} } -func NewInt32(v int32) *Int32 { return &Int32{v} } -func (i *Int32) Load() int32 { return a.LoadInt32(&i.value) } -func (i *Int32) Store(v int32) { a.StoreInt32(&i.value, v) } -func (i *Int32) Swap(new int32) int32 { return a.SwapInt32(&i.value, new) } -func (i *Int32) Add(delta int32) int32 { return a.AddInt32(&i.value, delta) } -func (i *Int32) Sub(delta int32) int32 { return a.AddInt32(&i.value, -delta) } -func (i *Int32) Inc() int32 { return i.Add(1) } -func (i *Int32) Dec() int32 { return i.Add(-1) } -func (i *Int32) CAS(old, new int32) bool { return a.CompareAndSwapInt32(&i.value, old, new) } - -func MakeInt64(v int64) Int64 { return Int64{v} } -func NewInt64(v int64) *Int64 { return &Int64{v} } -func (i *Int64) Load() int64 { return a.LoadInt64(&i.value) } -func (i *Int64) Store(v int64) { a.StoreInt64(&i.value, v) } -func (i *Int64) Swap(new int64) int64 { return a.SwapInt64(&i.value, new) } -func (i *Int64) Add(delta int64) int64 { return a.AddInt64(&i.value, delta) } -func (i *Int64) Sub(delta int64) int64 { return a.AddInt64(&i.value, -delta) } -func (i *Int64) Inc() int64 { return i.Add(1) } -func (i *Int64) Dec() int64 { return i.Add(-1) } -func (i *Int64) CAS(old, new int64) bool { return a.CompareAndSwapInt64(&i.value, old, new) } - -func MakeUint32(v uint32) Uint32 { return Uint32{v} } -func NewUint32(v uint32) *Uint32 { return &Uint32{v} } -func (u *Uint32) Load() uint32 { return a.LoadUint32(&u.value) } -func (u *Uint32) Store(v uint32) { a.StoreUint32(&u.value, v) } -func (u *Uint32) Swap(new uint32) uint32 { return a.SwapUint32(&u.value, new) } -func (u *Uint32) Add(delta uint32) uint32 { return a.AddUint32(&u.value, delta) } -func (u *Uint32) Sub(delta uint32) uint32 { return a.AddUint32(&u.value, ^uint32(delta-1)) } -func (u *Uint32) Inc() uint32 { return u.Add(1) } -func (u *Uint32) Dec() uint32 { return u.Add(^uint32(0)) } -func (u *Uint32) CAS(old, new uint32) bool { return a.CompareAndSwapUint32(&u.value, old, new) } - -func MakeUint64(v uint64) Uint64 { return Uint64{v} } -func NewUint64(v uint64) *Uint64 { return &Uint64{v} } -func (u *Uint64) Load() uint64 { return a.LoadUint64(&u.value) } -func (u *Uint64) Store(v uint64) { a.StoreUint64(&u.value, v) } -func (u *Uint64) Swap(new uint64) uint64 { return a.SwapUint64(&u.value, new) } -func (u *Uint64) Add(delta uint64) uint64 { return a.AddUint64(&u.value, delta) } -func (u *Uint64) Sub(delta uint64) uint64 { return a.AddUint64(&u.value, ^uint64(delta-1)) } -func (u *Uint64) Inc() uint64 { return u.Add(1) } -func (u *Uint64) Dec() uint64 { return u.Add(^uint64(0)) } -func (u *Uint64) CAS(old, new uint64) bool { return a.CompareAndSwapUint64(&u.value, old, new) } - -func encBool(b bool) uint32 { - if b { - return 1 - } - return 0 -} diff --git a/libbeat/common/atomic/atomic32.go b/libbeat/common/atomic/atomic32.go deleted file mode 100644 index d811070a6cd..00000000000 --- a/libbeat/common/atomic/atomic32.go +++ /dev/null @@ -1,50 +0,0 @@ -// Licensed to Elasticsearch B.V. under one or more contributor -// license agreements. See the NOTICE file distributed with -// this work for additional information regarding copyright -// ownership. Elasticsearch B.V. licenses this file to you 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 -// -// http://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. - -//go:build 386 || arm || mips || mipsle - -package atomic - -// atomic Uint/Int for 32bit systems - -// Uint provides an architecture specific atomic uint. -type Uint struct{ a Uint32 } - -// Int provides an architecture specific atomic uint. -type Int struct{ a Int32 } - -func MakeUint(v uint) Uint { return Uint{MakeUint32(uint32(v))} } -func NewUint(v uint) *Uint { return &Uint{MakeUint32(uint32(v))} } -func (u *Uint) Load() uint { return uint(u.a.Load()) } -func (u *Uint) Store(v uint) { u.a.Store(uint32(v)) } -func (u *Uint) Swap(new uint) uint { return uint(u.a.Swap(uint32(new))) } -func (u *Uint) Add(delta uint) uint { return uint(u.a.Add(uint32(delta))) } -func (u *Uint) Sub(delta uint) uint { return uint(u.a.Add(uint32(-delta))) } -func (u *Uint) Inc() uint { return uint(u.a.Inc()) } -func (u *Uint) Dec() uint { return uint(u.a.Dec()) } -func (u *Uint) CAS(old, new uint) bool { return u.a.CAS(uint32(old), uint32(new)) } - -func MakeInt(v int) Int { return Int{MakeInt32(int32(v))} } -func NewInt(v int) *Int { return &Int{MakeInt32(int32(v))} } -func (i *Int) Load() int { return int(i.a.Load()) } -func (i *Int) Store(v int) { i.a.Store(int32(v)) } -func (i *Int) Swap(new int) int { return int(i.a.Swap(int32(new))) } -func (i *Int) Add(delta int) int { return int(i.a.Add(int32(delta))) } -func (i *Int) Sub(delta int) int { return int(i.a.Add(int32(-delta))) } -func (i *Int) Inc() int { return int(i.a.Inc()) } -func (i *Int) Dec() int { return int(i.a.Dec()) } -func (i *Int) CAS(old, new int) bool { return i.a.CAS(int32(old), int32(new)) } diff --git a/libbeat/common/atomic/atomic64.go b/libbeat/common/atomic/atomic64.go deleted file mode 100644 index 3f3648e91ce..00000000000 --- a/libbeat/common/atomic/atomic64.go +++ /dev/null @@ -1,50 +0,0 @@ -// Licensed to Elasticsearch B.V. under one or more contributor -// license agreements. See the NOTICE file distributed with -// this work for additional information regarding copyright -// ownership. Elasticsearch B.V. licenses this file to you 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 -// -// http://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. - -//go:build amd64 || arm64 || ppc64 || ppc64le || mips64 || mips64le || s390x - -package atomic - -// atomic Uint/Int for 64bit systems - -// Uint provides an architecture specific atomic uint. -type Uint struct{ a Uint64 } - -// Int provides an architecture specific atomic uint. -type Int struct{ a Int64 } - -func MakeUint(v uint) Uint { return Uint{MakeUint64(uint64(v))} } -func NewUint(v uint) *Uint { return &Uint{MakeUint64(uint64(v))} } -func (u *Uint) Load() uint { return uint(u.a.Load()) } -func (u *Uint) Store(v uint) { u.a.Store(uint64(v)) } -func (u *Uint) Swap(new uint) uint { return uint(u.a.Swap(uint64(new))) } -func (u *Uint) Add(delta uint) uint { return uint(u.a.Add(uint64(delta))) } -func (u *Uint) Sub(delta uint) uint { return uint(u.a.Add(uint64(-delta))) } -func (u *Uint) Inc() uint { return uint(u.a.Inc()) } -func (u *Uint) Dec() uint { return uint(u.a.Dec()) } -func (u *Uint) CAS(old, new uint) bool { return u.a.CAS(uint64(old), uint64(new)) } - -func MakeInt(v int) Int { return Int{MakeInt64(int64(v))} } -func NewInt(v int) *Int { return &Int{MakeInt64(int64(v))} } -func (i *Int) Load() int { return int(i.a.Load()) } -func (i *Int) Store(v int) { i.a.Store(int64(v)) } -func (i *Int) Swap(new int) int { return int(i.a.Swap(int64(new))) } -func (i *Int) Add(delta int) int { return int(i.a.Add(int64(delta))) } -func (i *Int) Sub(delta int) int { return int(i.a.Add(int64(-delta))) } -func (i *Int) Inc() int { return int(i.a.Inc()) } -func (i *Int) Dec() int { return int(i.a.Dec()) } -func (i *Int) CAS(old, new int) bool { return i.a.CAS(int64(old), int64(new)) } diff --git a/libbeat/common/atomic/atomic_test.go b/libbeat/common/atomic/atomic_test.go deleted file mode 100644 index f4df6fc4d89..00000000000 --- a/libbeat/common/atomic/atomic_test.go +++ /dev/null @@ -1,273 +0,0 @@ -// Licensed to Elasticsearch B.V. under one or more contributor -// license agreements. See the NOTICE file distributed with -// this work for additional information regarding copyright -// ownership. Elasticsearch B.V. licenses this file to you 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 -// -// http://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. - -package atomic - -import ( - "testing" - - "github.com/stretchr/testify/assert" -) - -func TestAtomicBool(t *testing.T) { - assert := assert.New(t) - - var b Bool - assert.False(b.Load(), "check zero value is false") - - b = MakeBool(true) - assert.True(b.Load(), "check value initializer with 'true' value") - - b.Store(false) - assert.False(b.Load(), "check store to false") - - old := b.Swap(true) - assert.False(old, "check old value of swap operation is 'false'") - assert.True(b.Load(), "check new value after swap is 'true'") - - old = b.Swap(false) - assert.True(old, "check old value of second swap operation is 'true'") - assert.False(b.Load(), "check new value after second swap is 'false'") - - ok := b.CAS(true, true) - assert.False(ok, "check CAS fails with wrong 'old' value") - assert.False(b.Load(), "check failed CAS did not change value 'false'") - - ok = b.CAS(false, true) - assert.True(ok, "check CAS succeeds with correct 'old' value") - assert.True(b.Load(), "check CAS did change value to 'true'") -} - -func TestAtomicInt32(t *testing.T) { - assert := assert.New(t) - check := func(expected, actual int32, msg string) { - assert.Equal(expected, actual, msg) - } - - var v Int32 - check(0, v.Load(), "check zero value") - - v = MakeInt32(23) - check(23, v.Load(), "check value initializer") - - v.Store(42) - check(42, v.Load(), "check store new value") - - new := v.Inc() - check(43, new, "check increment returns new value") - check(43, v.Load(), "check increment did store new value") - - new = v.Dec() - check(42, new, "check decrement returns new value") - check(42, v.Load(), "check decrement did store new value") - - new = v.Add(8) - check(50, new, "check add returns new value") - check(50, v.Load(), "check add did store new value") - - new = v.Sub(8) - check(42, new, "check sub returns new value") - check(42, v.Load(), "check sub did store new value") - - old := v.Swap(101) - check(42, old, "check swap returns old value") - check(101, v.Load(), "check swap stores new value") - - ok := v.CAS(0, 23) - assert.False(ok, "check CAS with wrong old value fails") - check(101, v.Load(), "check failed CAS did not change value") - - ok = v.CAS(101, 23) - assert.True(ok, "check CAS succeeds") - check(23, v.Load(), "check CAS did store new value") -} - -func TestAtomicInt64(t *testing.T) { - assert := assert.New(t) - check := func(expected, actual int64, msg string) { - assert.Equal(expected, actual, msg) - } - - var v Int64 - check(0, v.Load(), "check zero value") - - v = MakeInt64(23) - check(23, v.Load(), "check value initializer") - - v.Store(42) - check(42, v.Load(), "check store new value") - - new := v.Inc() - check(43, new, "check increment returns new value") - check(43, v.Load(), "check increment did store new value") - - new = v.Dec() - check(42, new, "check decrement returns new value") - check(42, v.Load(), "check decrement did store new value") - - new = v.Add(8) - check(50, new, "check add returns new value") - check(50, v.Load(), "check add did store new value") - - new = v.Sub(8) - check(42, new, "check sub returns new value") - check(42, v.Load(), "check sub did store new value") - - old := v.Swap(101) - check(42, old, "check swap returns old value") - check(101, v.Load(), "check swap stores new value") - - ok := v.CAS(0, 23) - assert.False(ok, "check CAS with wrong old value fails") - check(101, v.Load(), "check failed CAS did not change value") - - ok = v.CAS(101, 23) - assert.True(ok, "check CAS succeeds") - check(23, v.Load(), "check CAS did store new value") -} - -func TestAtomicUint32(t *testing.T) { - assert := assert.New(t) - check := func(expected, actual uint32, msg string) { - assert.Equal(expected, actual, msg) - } - - var v Uint32 - check(0, v.Load(), "check zero value") - - v = MakeUint32(23) - check(23, v.Load(), "check value initializer") - - v.Store(42) - check(42, v.Load(), "check store new value") - - new := v.Inc() - check(43, new, "check increment returns new value") - check(43, v.Load(), "check increment did store new value") - - new = v.Dec() - check(42, new, "check decrement returns new value") - check(42, v.Load(), "check decrement did store new value") - - new = v.Add(8) - check(50, new, "check add returns new value") - check(50, v.Load(), "check add did store new value") - - new = v.Sub(8) - check(42, new, "check sub returns new value") - check(42, v.Load(), "check sub did store new value") - - old := v.Swap(101) - check(42, old, "check swap returns old value") - check(101, v.Load(), "check swap stores new value") - - ok := v.CAS(0, 23) - assert.False(ok, "check CAS with wrong old value fails") - check(101, v.Load(), "check failed CAS did not change value") - - ok = v.CAS(101, 23) - assert.True(ok, "check CAS succeeds") - check(23, v.Load(), "check CAS did store new value") -} - -func TestAtomicUint64(t *testing.T) { - assert := assert.New(t) - check := func(expected, actual uint64, msg string) { - assert.Equal(expected, actual, msg) - } - - var v Uint64 - check(0, v.Load(), "check zero value") - - v = MakeUint64(23) - check(23, v.Load(), "check value initializer") - - v.Store(42) - check(42, v.Load(), "check store new value") - - new := v.Inc() - check(43, new, "check increment returns new value") - check(43, v.Load(), "check increment did store new value") - - new = v.Dec() - check(42, new, "check decrement returns new value") - check(42, v.Load(), "check decrement did store new value") - - new = v.Add(8) - check(50, new, "check add returns new value") - check(50, v.Load(), "check add did store new value") - - new = v.Sub(8) - check(42, new, "check sub returns new value") - check(42, v.Load(), "check sub did store new value") - - old := v.Swap(101) - check(42, old, "check swap returns old value") - check(101, v.Load(), "check swap stores new value") - - ok := v.CAS(0, 23) - assert.False(ok, "check CAS with wrong old value fails") - check(101, v.Load(), "check failed CAS did not change value") - - ok = v.CAS(101, 23) - assert.True(ok, "check CAS succeeds") - check(23, v.Load(), "check CAS did store new value") -} - -func TestAtomicUint(t *testing.T) { - assert := assert.New(t) - check := func(expected, actual uint, msg string) { - assert.Equal(expected, actual, msg) - } - - var v Uint - check(0, v.Load(), "check zero value") - - v = MakeUint(23) - check(23, v.Load(), "check value initializer") - - v.Store(42) - check(42, v.Load(), "check store new value") - - new := v.Inc() - check(43, new, "check increment returns new value") - check(43, v.Load(), "check increment did store new value") - - new = v.Dec() - check(42, new, "check decrement returns new value") - check(42, v.Load(), "check decrement did store new value") - - new = v.Add(8) - check(50, new, "check add returns new value") - check(50, v.Load(), "check add did store new value") - - new = v.Sub(8) - check(42, new, "check sub returns new value") - check(42, v.Load(), "check sub did store new value") - - old := v.Swap(101) - check(42, old, "check swap returns old value") - check(101, v.Load(), "check swap stores new value") - - ok := v.CAS(0, 23) - assert.False(ok, "check CAS with wrong old value fails") - check(101, v.Load(), "check failed CAS did not change value") - - ok = v.CAS(101, 23) - assert.True(ok, "check CAS succeeds") - check(23, v.Load(), "check CAS did store new value") -} diff --git a/libbeat/idxmgmt/index_support.go b/libbeat/idxmgmt/index_support.go index 4526d916c35..57816b3625c 100644 --- a/libbeat/idxmgmt/index_support.go +++ b/libbeat/idxmgmt/index_support.go @@ -21,10 +21,10 @@ import ( "errors" "fmt" "strings" + "sync/atomic" "github.com/elastic/beats/v7/libbeat/beat" "github.com/elastic/beats/v7/libbeat/beat/events" - "github.com/elastic/beats/v7/libbeat/common/atomic" "github.com/elastic/beats/v7/libbeat/idxmgmt/lifecycle" "github.com/elastic/beats/v7/libbeat/outputs" "github.com/elastic/beats/v7/libbeat/outputs/outil" @@ -314,7 +314,7 @@ func (m *indexManager) setupWithILM() (bool, error) { } if withILM { // mark ILM as enabled in indexState - m.support.st.withILM.CAS(false, true) + m.support.st.withILM.CompareAndSwap(false, true) } } return withILM, nil diff --git a/libbeat/management/agent.go b/libbeat/management/agent.go index 84f5a1e9f6b..cd14f8cb969 100644 --- a/libbeat/management/agent.go +++ b/libbeat/management/agent.go @@ -17,17 +17,15 @@ package management -import ( - "github.com/elastic/beats/v7/libbeat/common/atomic" -) +import "sync/atomic" var ( // underAgent is set to true with this beat is being ran under the elastic-agent - underAgent = atomic.MakeBool(false) + underAgent atomic.Bool // underAgentTrace is set to true when the elastic-agent has placed this beat into // trace mode (which enables logging of published events) - underAgentTrace = atomic.MakeBool(false) + underAgentTrace atomic.Bool ) // SetUnderAgent sets that the processing pipeline is being ran under the elastic-agent. diff --git a/libbeat/outputs/elasticsearch/client_proxy_test.go b/libbeat/outputs/elasticsearch/client_proxy_test.go index bd6739c3bf0..b0cef282487 100644 --- a/libbeat/outputs/elasticsearch/client_proxy_test.go +++ b/libbeat/outputs/elasticsearch/client_proxy_test.go @@ -29,12 +29,12 @@ import ( "net/url" "os" "os/exec" + "sync/atomic" "testing" "github.com/stretchr/testify/assert" "github.com/stretchr/testify/require" - "github.com/elastic/beats/v7/libbeat/common/atomic" "github.com/elastic/beats/v7/libbeat/esleg/eslegclient" "github.com/elastic/beats/v7/libbeat/outputs/outil" "github.com/elastic/elastic-agent-libs/transport/httpcommon" @@ -224,17 +224,17 @@ type serverState struct { serverURL string proxyURL string - _serverRequestCount atomic.Int // Requests directly to the server - _proxyRequestCount atomic.Int // Requests via the proxy + _serverRequestCount atomic.Int64 // Requests directly to the server + _proxyRequestCount atomic.Int64 // Requests via the proxy } // Convenience functions to unwrap the atomic primitives -func (s serverState) serverRequestCount() int { - return s._serverRequestCount.Load() +func (s *serverState) serverRequestCount() int { + return int(s._serverRequestCount.Load()) } -func (s serverState) proxyRequestCount() int { - return s._proxyRequestCount.Load() +func (s *serverState) proxyRequestCount() int { + return int(s._proxyRequestCount.Load()) } // startServers starts endpoints representing a backend server and a proxy, @@ -246,13 +246,13 @@ func startServers(t *testing.T) (*serverState, func()) { http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { assert.Equal(t, headerTestValue, r.Header.Get(headerTestField)) fmt.Fprintln(w, "Hello, client") - state._serverRequestCount.Inc() + state._serverRequestCount.Add(1) })) proxy := httptest.NewServer( http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { assert.Equal(t, headerTestValue, r.Header.Get(headerTestField)) fmt.Fprintln(w, "Hello, client") - state._proxyRequestCount.Inc() + state._proxyRequestCount.Add(1) })) state.serverURL = server.URL state.proxyURL = proxy.URL diff --git a/libbeat/outputs/logstash/async.go b/libbeat/outputs/logstash/async.go index a980d1cef32..f0da5e45943 100644 --- a/libbeat/outputs/logstash/async.go +++ b/libbeat/outputs/logstash/async.go @@ -22,10 +22,10 @@ import ( "errors" "net" "sync" + "sync/atomic" "time" "github.com/elastic/beats/v7/libbeat/beat" - "github.com/elastic/beats/v7/libbeat/common/atomic" "github.com/elastic/beats/v7/libbeat/outputs" "github.com/elastic/beats/v7/libbeat/publisher" "github.com/elastic/elastic-agent-libs/logp" @@ -147,13 +147,13 @@ func (c *asyncClient) Publish(_ context.Context, batch publisher.Batch) error { ref := &msgRef{ client: c, - count: atomic.MakeUint32(1), batch: batch, slice: events, batchSize: len(events), win: c.win, err: nil, } + ref.count.Store(1) defer ref.dec() for len(events) > 0 { @@ -218,7 +218,7 @@ func (c *asyncClient) sendEvents(ref *msgRef, events []publisher.Event) error { for i := range events { window[i] = &events[i].Content } - ref.count.Inc() + ref.count.Add(1) return client.Send(ref.callback, window) } @@ -261,7 +261,7 @@ func (r *msgRef) fail(n uint32, err error) { } func (r *msgRef) dec() { - i := r.count.Dec() + i := r.count.Add(^uint32(0)) if i > 0 { return } diff --git a/libbeat/processors/add_process_metadata/add_process_metadata.go b/libbeat/processors/add_process_metadata/add_process_metadata.go index 2385e5f99de..78e67f8e4d7 100644 --- a/libbeat/processors/add_process_metadata/add_process_metadata.go +++ b/libbeat/processors/add_process_metadata/add_process_metadata.go @@ -22,11 +22,11 @@ import ( "fmt" "reflect" "strconv" + "sync/atomic" "time" "github.com/elastic/beats/v7/libbeat/beat" "github.com/elastic/beats/v7/libbeat/common" - "github.com/elastic/beats/v7/libbeat/common/atomic" "github.com/elastic/beats/v7/libbeat/processors" jsprocessor "github.com/elastic/beats/v7/libbeat/processors/script/javascript/module/processor" conf "github.com/elastic/elastic-agent-libs/config" @@ -131,7 +131,7 @@ func NewWithConfig(opts ...ConfigOption) (beat.Processor, error) { func newProcessMetadataProcessorWithProvider(config config, provider processMetadataProvider, withCache bool) (proc beat.Processor, err error) { // Logging (each processor instance has a unique ID). var ( - id = int(instanceID.Inc()) + id = int(instanceID.Add(1)) log = logp.NewLogger(processorName).With("instance_id", id) ) diff --git a/libbeat/processors/cache/cache.go b/libbeat/processors/cache/cache.go index a7ce4876f50..45c1e41872e 100644 --- a/libbeat/processors/cache/cache.go +++ b/libbeat/processors/cache/cache.go @@ -22,10 +22,10 @@ import ( "errors" "fmt" "os" + "sync/atomic" "time" "github.com/elastic/beats/v7/libbeat/beat" - "github.com/elastic/beats/v7/libbeat/common/atomic" "github.com/elastic/beats/v7/libbeat/processors" conf "github.com/elastic/elastic-agent-libs/config" "github.com/elastic/elastic-agent-libs/logp" @@ -67,7 +67,7 @@ func New(cfg *conf.C) (beat.Processor, error) { return nil, fmt.Errorf("failed to unpack the %s configuration: %w", name, err) } // Logging (each processor instance has a unique ID). - id := int(instanceID.Inc()) + id := int(instanceID.Add(1)) log := logp.NewLogger(name).With("instance_id", id) src, cancel, err := getStoreFor(config, log) diff --git a/libbeat/processors/dns/dns.go b/libbeat/processors/dns/dns.go index d4f3d2ba57b..48b08ab671c 100644 --- a/libbeat/processors/dns/dns.go +++ b/libbeat/processors/dns/dns.go @@ -22,9 +22,9 @@ import ( "strconv" "strings" "sync" + "sync/atomic" "github.com/elastic/beats/v7/libbeat/beat" - "github.com/elastic/beats/v7/libbeat/common/atomic" "github.com/elastic/beats/v7/libbeat/processors" jsprocessor "github.com/elastic/beats/v7/libbeat/processors/script/javascript/module/processor" conf "github.com/elastic/elastic-agent-libs/config" @@ -36,7 +36,7 @@ import ( const logName = "processor.dns" // instanceID is used to assign each instance a unique monitoring namespace. -var instanceID = atomic.MakeUint32(0) +var instanceID atomic.Uint32 func init() { processors.RegisterPlugin("dns", New) @@ -58,7 +58,7 @@ func New(cfg *conf.C) (beat.Processor, error) { // Logging and metrics (each processor instance has a unique ID). var ( - id = int(instanceID.Inc()) + id = int(instanceID.Add(1)) log = logp.NewLogger(logName).With("instance_id", id) metrics = monitoring.Default.NewRegistry(logName+"."+strconv.Itoa(id), monitoring.DoNotReport) ) diff --git a/libbeat/processors/ratelimit/rate_limit.go b/libbeat/processors/ratelimit/rate_limit.go index f558b076e2b..92d9b4c37a0 100644 --- a/libbeat/processors/ratelimit/rate_limit.go +++ b/libbeat/processors/ratelimit/rate_limit.go @@ -22,12 +22,12 @@ import ( "fmt" "sort" "strconv" + "sync/atomic" "github.com/jonboulle/clockwork" "github.com/mitchellh/hashstructure" "github.com/elastic/beats/v7/libbeat/beat" - "github.com/elastic/beats/v7/libbeat/common/atomic" "github.com/elastic/beats/v7/libbeat/processors" c "github.com/elastic/elastic-agent-libs/config" "github.com/elastic/elastic-agent-libs/logp" @@ -36,7 +36,7 @@ import ( ) // instanceID is used to assign each instance a unique monitoring namespace. -var instanceID = atomic.MakeUint32(0) +var instanceID atomic.Uint32 const processorName = "rate_limit" const logName = "processor." + processorName @@ -79,7 +79,7 @@ func new(cfg *c.C) (beat.Processor, error) { // Logging and metrics (each processor instance has a unique ID). var ( - id = int(instanceID.Inc()) + id = int(instanceID.Add(1)) log = logp.NewLogger(logName).With("instance_id", id) reg = monitoring.Default.NewRegistry(logName+"."+strconv.Itoa(id), monitoring.DoNotReport) ) diff --git a/libbeat/processors/ratelimit/token_bucket.go b/libbeat/processors/ratelimit/token_bucket.go index 1f1381fd8df..1e84f799b98 100644 --- a/libbeat/processors/ratelimit/token_bucket.go +++ b/libbeat/processors/ratelimit/token_bucket.go @@ -20,13 +20,13 @@ package ratelimit import ( "fmt" "sync" + "sync/atomic" "time" "github.com/jonboulle/clockwork" "github.com/elastic/go-concert/unison" - "github.com/elastic/beats/v7/libbeat/common/atomic" "github.com/elastic/elastic-agent-libs/logp" ) @@ -50,7 +50,7 @@ type tokenBucket struct { gc struct { thresholds tokenBucketGCConfig metrics struct { - numCalls atomic.Uint + numCalls atomic.Uint64 } } @@ -93,7 +93,7 @@ func newTokenBucket(config algoConfig) (algorithm, error) { gc: struct { thresholds tokenBucketGCConfig metrics struct { - numCalls atomic.Uint + numCalls atomic.Uint64 } }{ thresholds: tokenBucketGCConfig{ @@ -112,7 +112,7 @@ func (t *tokenBucket) IsAllowed(key uint64) bool { b := t.getBucket(key) allowed := b.withdraw() - t.gc.metrics.numCalls.Inc() + t.gc.metrics.numCalls.Add(1) return allowed } @@ -126,6 +126,7 @@ func (t *tokenBucket) getBucket(key uint64) *bucket { tokens: t.depth, lastReplenish: t.clock.Now(), }) + //nolint:errcheck // ignore b := v.(*bucket) if exists { @@ -154,7 +155,7 @@ func (b *bucket) replenish(rate rate, clock clockwork.Clock) { func (t *tokenBucket) runGC() { // Don't run GC if thresholds haven't been crossed. - if t.gc.metrics.numCalls.Load() < t.gc.thresholds.NumCalls { + if t.gc.metrics.numCalls.Load() < uint64(t.gc.thresholds.NumCalls) { return } @@ -171,7 +172,9 @@ func (t *tokenBucket) runGC() { toDelete := make([]uint64, 0) numBucketsBefore := 0 t.buckets.Range(func(k, v interface{}) bool { + //nolint:errcheck // ignore key := k.(uint64) + //nolint:errcheck // ignore b := v.(*bucket) b.replenish(t.limit, t.clock) @@ -190,9 +193,9 @@ func (t *tokenBucket) runGC() { } // Reset GC metrics - t.gc.metrics.numCalls = atomic.MakeUint(0) + t.gc.metrics.numCalls = atomic.Uint64{} - gcDuration := time.Now().Sub(gcStartTime) + gcDuration := time.Since(gcStartTime) numBucketsDeleted := len(toDelete) numBucketsAfter := numBucketsBefore - numBucketsDeleted t.logger.Debugf("gc duration: %v, buckets: (before: %v, deleted: %v, after: %v)", diff --git a/libbeat/processors/syslog/syslog.go b/libbeat/processors/syslog/syslog.go index 96c21d3d773..9a6e71fcca3 100644 --- a/libbeat/processors/syslog/syslog.go +++ b/libbeat/processors/syslog/syslog.go @@ -22,9 +22,9 @@ import ( "errors" "fmt" "strconv" + "sync/atomic" "github.com/elastic/beats/v7/libbeat/beat" - "github.com/elastic/beats/v7/libbeat/common/atomic" "github.com/elastic/beats/v7/libbeat/common/cfgtype" "github.com/elastic/beats/v7/libbeat/common/jsontransform" "github.com/elastic/beats/v7/libbeat/processors" @@ -43,7 +43,7 @@ const ( ) // instanceID is used to assign each instance a unique monitoring namespace. -var instanceID = atomic.MakeUint32(0) +var instanceID atomic.Uint32 // config defines the configuration for this processor. type config struct { @@ -114,7 +114,7 @@ func New(c *conf.C) (beat.Processor, error) { return nil, fmt.Errorf("fail to unpack the "+procName+" processor configuration: %w", err) } - id := int(instanceID.Inc()) + id := int(instanceID.Add(1)) log := logp.NewLogger(logName).With("instance_id", id) registryName := logName + "." + strconv.Itoa(id) diff --git a/libbeat/publisher/pipeline/client.go b/libbeat/publisher/pipeline/client.go index af756213a63..3048ec4a001 100644 --- a/libbeat/publisher/pipeline/client.go +++ b/libbeat/publisher/pipeline/client.go @@ -19,10 +19,10 @@ package pipeline import ( "sync" + "sync/atomic" "time" "github.com/elastic/beats/v7/libbeat/beat" - "github.com/elastic/beats/v7/libbeat/common/atomic" "github.com/elastic/beats/v7/libbeat/processors" "github.com/elastic/beats/v7/libbeat/publisher" "github.com/elastic/beats/v7/libbeat/publisher/queue" @@ -41,8 +41,7 @@ type client struct { canDrop bool // Open state, signaling, and sync primitives for coordinating client Close. - isOpen atomic.Bool // set to false during shutdown, such that no new events will be accepted anymore. - closeOnce sync.Once // closeOnce ensure that the client shutdown sequence is only executed once + isOpen atomic.Bool // set to false during shutdown, such that no new events will be accepted anymore. observer observer eventListener beat.EventListener @@ -204,12 +203,12 @@ func newClientCloseWaiter(timeout time.Duration) *clientCloseWaiter { func (w *clientCloseWaiter) AddEvent(_ beat.Event, published bool) { if published { - w.events.Inc() + w.events.Add(1) } } func (w *clientCloseWaiter) ACKEvents(n int) { - value := w.events.Sub(uint32(n)) + value := w.events.Add(^uint32(n - 1)) if value != 0 { return } diff --git a/libbeat/publisher/pipeline/client_worker_test.go b/libbeat/publisher/pipeline/client_worker_test.go index 97692b2aada..ed97cd11ac8 100644 --- a/libbeat/publisher/pipeline/client_worker_test.go +++ b/libbeat/publisher/pipeline/client_worker_test.go @@ -22,6 +22,7 @@ import ( "math" "strings" "sync" + "sync/atomic" "testing" "testing/quick" "time" @@ -30,7 +31,6 @@ import ( "github.com/stretchr/testify/require" - "github.com/elastic/beats/v7/libbeat/common/atomic" "github.com/elastic/beats/v7/libbeat/internal/testutil" "github.com/elastic/beats/v7/libbeat/outputs" "github.com/elastic/beats/v7/libbeat/publisher" @@ -48,7 +48,7 @@ func TestMakeClientWorker(t *testing.T) { err := quick.Check(func(i uint) bool { numBatches := 300 + (i % 100) // between 300 and 399 - var numEvents uint + var numEvents uint64 logger := makeBufLogger(t) @@ -56,9 +56,9 @@ func TestMakeClientWorker(t *testing.T) { retryer := newStandaloneRetryer(workQueue) defer retryer.close() - var published atomic.Uint + var published atomic.Uint64 publishFn := func(batch publisher.Batch) error { - published.Add(uint(len(batch.Events()))) + published.Add(uint64(len(batch.Events()))) return nil } @@ -69,7 +69,7 @@ func TestMakeClientWorker(t *testing.T) { for i := uint(0); i < numBatches; i++ { batch := randomBatch(50, 150).withRetryer(retryer) - numEvents += uint(len(batch.Events())) + numEvents += uint64(len(batch.Events())) workQueue <- batch } @@ -82,7 +82,7 @@ func TestMakeClientWorker(t *testing.T) { }) if !success { logger.Flush() - t.Logf("numBatches = %v, numEvents = %v, published = %v", numBatches, numEvents, published) + t.Logf("numBatches = %v, numEvents = %v, published = %v", numBatches, numEvents, published.Load()) } return success }, nil) @@ -140,9 +140,9 @@ func TestReplaceClientWorker(t *testing.T) { }() // Publish at least 1 batch worth of events but no more than 20% events - publishLimit := uint(math.Max(minEventsInBatch, float64(numEvents)*0.2)) + publishLimit := uint64(math.Max(minEventsInBatch, float64(numEvents)*0.2)) - var publishedFirst atomic.Uint + var publishedFirst atomic.Uint64 blockCtrl := make(chan struct{}) blockingPublishFn := func(batch publisher.Batch) error { // Emulate blocking. Upon unblocking the in-flight batch that was @@ -152,7 +152,7 @@ func TestReplaceClientWorker(t *testing.T) { } count := len(batch.Events()) - publishedFirst.Add(uint(count)) + publishedFirst.Add(uint64(count)) t.Logf("#1 processed batch: %v (%v)", batch.(*mockBatch).events[0].Content.Private, count) return nil } @@ -176,10 +176,10 @@ func TestReplaceClientWorker(t *testing.T) { close(blockCtrl) // Start new worker to drain work queue - var publishedLater atomic.Uint + var publishedLater atomic.Uint64 countingPublishFn := func(batch publisher.Batch) error { count := len(batch.Events()) - publishedLater.Add(uint(count)) + publishedLater.Add(uint64(count)) t.Logf("#2 processed batch: %v (%v)", batch.(*mockBatch).events[0].Content.Private, count) return nil } @@ -212,7 +212,7 @@ func TestMakeClientTracer(t *testing.T) { testutil.SeedPRNG(t) numBatches := 10 - var numEvents uint + var numEvents uint64 logger := makeBufLogger(t) @@ -220,9 +220,9 @@ func TestMakeClientTracer(t *testing.T) { retryer := newStandaloneRetryer(workQueue) defer retryer.close() - var published atomic.Uint + var published atomic.Uint64 publishFn := func(batch publisher.Batch) error { - published.Add(uint(len(batch.Events()))) + published.Add(uint64(len(batch.Events()))) return nil } @@ -236,7 +236,7 @@ func TestMakeClientTracer(t *testing.T) { for i := 0; i < numBatches; i++ { batch := randomBatch(10, 15).withRetryer(retryer) - numEvents += uint(len(batch.Events())) + numEvents += uint64(len(batch.Events())) workQueue <- batch } @@ -248,7 +248,7 @@ func TestMakeClientTracer(t *testing.T) { return numEvents == published.Load() }) if !matches { - t.Errorf("expected %d events, got %d", numEvents, published) + t.Errorf("expected %d events, got %d", numEvents, published.Load()) } recorder.Flush(nil) diff --git a/libbeat/publisher/pipeline/controller_test.go b/libbeat/publisher/pipeline/controller_test.go index 706c159e3d4..5e48fbb79b8 100644 --- a/libbeat/publisher/pipeline/controller_test.go +++ b/libbeat/publisher/pipeline/controller_test.go @@ -20,12 +20,12 @@ package pipeline import ( "fmt" "sync" + "sync/atomic" "testing" "testing/quick" "time" "github.com/elastic/beats/v7/libbeat/beat" - "github.com/elastic/beats/v7/libbeat/common/atomic" "github.com/elastic/beats/v7/libbeat/internal/testutil" "github.com/elastic/beats/v7/libbeat/outputs" "github.com/elastic/beats/v7/libbeat/publisher" @@ -64,9 +64,9 @@ func TestOutputReload(t *testing.T) { fmt.Sprintf("mem.events: %v", numEventsToPublish)) _ = queueConfig.Unpack(conf) - var publishedCount atomic.Uint + var publishedCount atomic.Uint64 countingPublishFn := func(batch publisher.Batch) error { - publishedCount.Add(uint(len(batch.Events()))) + publishedCount.Add(uint64(len(batch.Events()))) return nil } @@ -108,7 +108,7 @@ func TestOutputReload(t *testing.T) { timeout := 20 * time.Second return waitUntilTrue(timeout, func() bool { - return numEventsToPublish == publishedCount.Load() + return uint64(numEventsToPublish) == publishedCount.Load() }) }, &quick.Config{MaxCount: 25}) @@ -222,18 +222,19 @@ func TestQueueProducerBlocksUntilOutputIsSet(t *testing.T) { // block, because there is no queue, but they should become unblocked // once we set a nonempty output. const producerCount = 10 - remaining := atomic.MakeInt(producerCount) + var remaining atomic.Int64 + remaining.Store(producerCount) for i := 0; i < producerCount; i++ { go func() { controller.queueProducer(queue.ProducerConfig{}) - remaining.Dec() + remaining.Add(-1) }() } allStarted := waitUntilTrue(time.Second, func() bool { return len(controller.pendingRequests) == producerCount }) assert.True(t, allStarted, "All queueProducer requests should be saved as pending requests by outputController") - assert.Equal(t, producerCount, remaining.Load(), "No queueProducer request should return before an output is set") + assert.Equal(t, int64(producerCount), remaining.Load(), "No queueProducer request should return before an output is set") // Set the output, then ensure that it unblocks all the waiting goroutines. controller.Set(outputs.Group{ diff --git a/libbeat/publisher/pipeline/pipeline.go b/libbeat/publisher/pipeline/pipeline.go index a5a13a0584e..6297f7b7ee6 100644 --- a/libbeat/publisher/pipeline/pipeline.go +++ b/libbeat/publisher/pipeline/pipeline.go @@ -26,7 +26,6 @@ import ( "github.com/elastic/beats/v7/libbeat/beat" "github.com/elastic/beats/v7/libbeat/common/acker" - "github.com/elastic/beats/v7/libbeat/common/atomic" "github.com/elastic/beats/v7/libbeat/common/reload" "github.com/elastic/beats/v7/libbeat/outputs" "github.com/elastic/beats/v7/libbeat/publisher" @@ -211,13 +210,13 @@ func (p *Pipeline) ConnectWith(cfg beat.ClientConfig) (beat.Client, error) { client := &client{ logger: p.monitors.Logger, - isOpen: atomic.MakeBool(true), clientListener: cfg.ClientListener, processors: processors, eventFlags: eventFlags, canDrop: canDrop, observer: p.observer, } + client.isOpen.Store(true) ackHandler := cfg.EventListener diff --git a/libbeat/publisher/pipeline/pipeline_test.go b/libbeat/publisher/pipeline/pipeline_test.go index a8cf34b895a..bd374c3c87b 100644 --- a/libbeat/publisher/pipeline/pipeline_test.go +++ b/libbeat/publisher/pipeline/pipeline_test.go @@ -20,10 +20,10 @@ package pipeline import ( "runtime" "sync" + "sync/atomic" "testing" "github.com/elastic/beats/v7/libbeat/beat" - "github.com/elastic/beats/v7/libbeat/common/atomic" "github.com/elastic/beats/v7/libbeat/publisher/queue" "github.com/elastic/beats/v7/libbeat/tests/resources" "github.com/elastic/elastic-agent-libs/mapstr" @@ -79,7 +79,7 @@ func TestPipelineAcceptsAnyNumberOfClients(t *testing.T) { // close method is called, this ID is returned func makeDiscardQueue() queue.Queue { var wg sync.WaitGroup - producerID := atomic.NewInt(0) + var producerID atomic.Int64 return &testQueue{ close: func() error { @@ -92,7 +92,7 @@ func makeDiscardQueue() queue.Queue { }, producer: func(cfg queue.ProducerConfig) queue.Producer { - producerID.Inc() + producerID.Add(1) // count is a counter that increments on every published event // it's also the returned Event ID @@ -231,11 +231,11 @@ func makeTestQueue() queue.Queue { func blockingProducer(_ queue.ProducerConfig) queue.Producer { sig := make(chan struct{}) - waiting := atomic.MakeInt(0) + var waiting atomic.Int64 return &testProducer{ publish: func(_ bool, _ queue.Entry) (queue.EntryID, bool) { - waiting.Inc() + waiting.Add(1) <-sig return 0, false }, diff --git a/libbeat/publisher/pipeline/stress/gen.go b/libbeat/publisher/pipeline/stress/gen.go index 2a4d8c72ef0..7fdf17bd27b 100644 --- a/libbeat/publisher/pipeline/stress/gen.go +++ b/libbeat/publisher/pipeline/stress/gen.go @@ -22,6 +22,7 @@ import ( "fmt" "runtime/pprof" "sync" + "sync/atomic" "time" "github.com/elastic/elastic-agent-libs/logp" @@ -29,7 +30,6 @@ import ( "github.com/elastic/beats/v7/libbeat/beat" "github.com/elastic/beats/v7/libbeat/common/acker" - "github.com/elastic/beats/v7/libbeat/common/atomic" ) type generateConfig struct { @@ -97,7 +97,7 @@ func generate( done := make(chan struct{}) defer close(done) - count := atomic.MakeUint64(0) + var count atomic.Uint64 var wg sync.WaitGroup defer wg.Wait() @@ -148,7 +148,7 @@ func generate( Fields: mapstr.M{ "id": id, "hello": "world", - "count": count, + "count": count.Load(), // TODO: more custom event generation? }, @@ -156,7 +156,7 @@ func generate( client.Publish(event) - total := count.Inc() + total := count.Add(1) if config.MaxEvents > 0 && total == config.MaxEvents { break } diff --git a/libbeat/publisher/pipeline/stress/sig.go b/libbeat/publisher/pipeline/stress/sig.go index 537fc9c633b..d6d03f0c3d1 100644 --- a/libbeat/publisher/pipeline/stress/sig.go +++ b/libbeat/publisher/pipeline/stress/sig.go @@ -17,7 +17,7 @@ package stress -import "github.com/elastic/beats/v7/libbeat/common/atomic" +import "sync/atomic" type closeSignaler struct { active atomic.Bool @@ -25,14 +25,15 @@ type closeSignaler struct { } func newCloseSignaler() *closeSignaler { - return &closeSignaler{ - active: atomic.MakeBool(true), - done: make(chan struct{}), + cs := &closeSignaler{ + done: make(chan struct{}), } + cs.active.Store(true) + return cs } func (s *closeSignaler) Close() { - if act := s.active.Swap(false); act { + if s.active.Swap(false) { close(s.done) } } diff --git a/libbeat/publisher/testing/connector.go b/libbeat/publisher/testing/connector.go index ddf48cc126f..967f86ebe28 100644 --- a/libbeat/publisher/testing/connector.go +++ b/libbeat/publisher/testing/connector.go @@ -18,15 +18,16 @@ package testing import ( + "sync/atomic" + "github.com/elastic/beats/v7/libbeat/beat" - "github.com/elastic/beats/v7/libbeat/common/atomic" ) // ClientCounter can be used to create a beat.PipelineConnector that count // pipeline connects and disconnects. type ClientCounter struct { - total atomic.Int - active atomic.Int + total atomic.Int64 + active atomic.Int64 } // FakeConnector implements the beat.PipelineConnector interface. @@ -111,21 +112,21 @@ func ChClient(ch chan beat.Event) beat.Client { } // Active returns the number of currently active connections. -func (c *ClientCounter) Active() int { return c.active.Load() } +func (c *ClientCounter) Active() int { return int(c.active.Load()) } // Total returns the total number of calls to Connect. -func (c *ClientCounter) Total() int { return c.total.Load() } +func (c *ClientCounter) Total() int { return int(c.total.Load()) } // BuildConnector create a pipeline that updates the active and tocal // connection counters on Connect and Close calls. func (c *ClientCounter) BuildConnector() beat.PipelineConnector { return FakeConnector{ ConnectFunc: func(_ beat.ClientConfig) (beat.Client, error) { - c.total.Inc() - c.active.Inc() + c.total.Add(1) + c.active.Add(1) return &FakeClient{ CloseFunc: func() error { - c.active.Dec() + c.active.Add(-1) return nil }, }, nil diff --git a/libbeat/tests/integration/framework.go b/libbeat/tests/integration/framework.go index 904fc1e302a..aa05d6ff0e6 100644 --- a/libbeat/tests/integration/framework.go +++ b/libbeat/tests/integration/framework.go @@ -37,13 +37,12 @@ import ( "strconv" "strings" "sync" + "sync/atomic" "testing" "time" "github.com/gofrs/uuid/v5" "github.com/stretchr/testify/require" - - "github.com/elastic/beats/v7/libbeat/common/atomic" ) type BeatProc struct { @@ -189,7 +188,7 @@ func (b *BeatProc) Start(args ...string) { b.fullPath = fullPath b.Args = append(b.baseArgs, args...) - done := atomic.MakeBool(false) + var done atomic.Bool wg := sync.WaitGroup{} if b.RestartOnBeatOnExit { wg.Add(1) diff --git a/metricbeat/mb/module/runner_group_test.go b/metricbeat/mb/module/runner_group_test.go index 1d462359968..2cd6e6cc8b5 100644 --- a/metricbeat/mb/module/runner_group_test.go +++ b/metricbeat/mb/module/runner_group_test.go @@ -19,13 +19,13 @@ package module import ( "fmt" + "sync/atomic" "testing" "github.com/stretchr/testify/assert" "github.com/stretchr/testify/require" "github.com/elastic/beats/v7/libbeat/cfgfile" - "github.com/elastic/beats/v7/libbeat/common/atomic" "github.com/elastic/beats/v7/libbeat/common/diagnostics" ) @@ -55,19 +55,19 @@ func (fr *fakeRunnerDiag) Diagnostics() []diagnostics.DiagnosticSetup { type fakeRunner struct { id int - startCounter *atomic.Int - stopCounter *atomic.Int + startCounter *atomic.Int64 + stopCounter *atomic.Int64 } func (fr *fakeRunner) Start() { if fr.startCounter != nil { - fr.startCounter.Inc() + fr.startCounter.Add(1) } } func (fr *fakeRunner) Stop() { if fr.stopCounter != nil { - fr.stopCounter.Inc() + fr.stopCounter.Add(1) } } @@ -76,15 +76,14 @@ func (fr *fakeRunner) String() string { } func TestStartStop(t *testing.T) { - startCounter := atomic.NewInt(0) - stopCounter := atomic.NewInt(0) + var startCounter, stopCounter atomic.Int64 runners := make([]cfgfile.Runner, 0, fakeRunnersNum) for i := 0; i < fakeRunnersNum; i++ { runners = append(runners, &fakeRunner{ id: i, - startCounter: startCounter, - stopCounter: stopCounter, + startCounter: &startCounter, + stopCounter: &stopCounter, }) } @@ -93,8 +92,8 @@ func TestStartStop(t *testing.T) { runnerGroup.Stop() - assert.Equal(t, fakeRunnersNum, startCounter.Load()) - assert.Equal(t, fakeRunnersNum, stopCounter.Load()) + assert.Equal(t, int64(fakeRunnersNum), startCounter.Load()) + assert.Equal(t, int64(fakeRunnersNum), stopCounter.Load()) } func TestDiagnosticsUnsupported(t *testing.T) { @@ -102,8 +101,8 @@ func TestDiagnosticsUnsupported(t *testing.T) { for i := 0; i < fakeRunnersNum; i++ { runners = append(runners, &fakeRunner{ id: i, - startCounter: atomic.NewInt(0), - stopCounter: atomic.NewInt(0), + startCounter: &atomic.Int64{}, + stopCounter: &atomic.Int64{}, }) } diff --git a/packetbeat/sniffer/sniffer.go b/packetbeat/sniffer/sniffer.go index d8043032a64..24c77180b46 100644 --- a/packetbeat/sniffer/sniffer.go +++ b/packetbeat/sniffer/sniffer.go @@ -25,6 +25,7 @@ import ( "os" "runtime" "strings" + "sync/atomic" "time" "github.com/google/gopacket" @@ -33,7 +34,6 @@ import ( "github.com/google/gopacket/pcapgo" "golang.org/x/sync/errgroup" - "github.com/elastic/beats/v7/libbeat/common/atomic" "github.com/elastic/elastic-agent-libs/logp" "github.com/elastic/beats/v7/packetbeat/config" @@ -51,7 +51,7 @@ type Sniffer struct { type sniffer struct { config config.InterfaceConfig - state atomic.Int32 // store snifferState + state *atomic.Int32 // store snifferState // device is the first active device after calling New. // It is not updated by default route polling. @@ -103,13 +103,14 @@ func New(id string, testMode bool, _ string, decoders map[string]Decoders, inter return nil, fmt.Errorf("no decoder for %s", iface.Device) } child := sniffer{ - state: atomic.MakeInt32(snifferInactive), + state: &atomic.Int32{}, followDefault: iface.PollDefaultRoute > 0 && strings.HasPrefix(iface.Device, "default_route"), id: id, idx: i, decoders: dec, log: s.log, } + child.state.Store(snifferInactive) s.log.Debugf("interface: %d, BPF filter: '%s'", i, iface.BpfFilter) @@ -373,7 +374,7 @@ func (s *sniffer) sniffHandle(ctx context.Context, handle snifferHandle, dec *de // Mark inactive sniffer as active. In case of the sniffer/packetbeat closing // before/while Run is executed, the state will be snifferClosing. // => return if state is already snifferClosing. - if !s.state.CAS(snifferInactive, snifferActive) { + if !s.state.CompareAndSwap(snifferInactive, snifferActive) { return nil } defer s.state.Store(snifferInactive) diff --git a/winlogbeat/beater/acker.go b/winlogbeat/beater/acker.go index e9cc2e77c33..d35a0166484 100644 --- a/winlogbeat/beater/acker.go +++ b/winlogbeat/beater/acker.go @@ -20,20 +20,20 @@ package beater import ( "context" "sync" + "sync/atomic" - "github.com/elastic/beats/v7/libbeat/common/atomic" "github.com/elastic/beats/v7/winlogbeat/checkpoint" ) type eventACKer struct { - active *atomic.Int + active *atomic.Int64 wg *sync.WaitGroup checkpoint *checkpoint.Checkpoint } func newEventACKer(checkpoint *checkpoint.Checkpoint) *eventACKer { return &eventACKer{ - active: atomic.NewInt(0), + active: &atomic.Int64{}, wg: &sync.WaitGroup{}, checkpoint: checkpoint, } @@ -55,7 +55,7 @@ func (a *eventACKer) ACKEvents(data []interface{}) { } // Mark events as done (subtract). - a.active.Add(-1 * len(data)) + a.active.Add(-1 * int64(len(data))) a.wg.Add(-1 * len(data)) } @@ -71,11 +71,11 @@ func (a *eventACKer) Wait(ctx context.Context) { // Add adds to the number of active events. func (a *eventACKer) Add(delta int) { - a.active.Add(delta) + a.active.Add(int64(delta)) a.wg.Add(delta) } // Active returns the number of active events (published but not yet ACKed). func (a *eventACKer) Active() int { - return a.active.Load() + return int(a.active.Load()) } diff --git a/winlogbeat/sys/wineventlog/renderer_test.go b/winlogbeat/sys/wineventlog/renderer_test.go index 339122d8a29..01089b5a112 100644 --- a/winlogbeat/sys/wineventlog/renderer_test.go +++ b/winlogbeat/sys/wineventlog/renderer_test.go @@ -26,13 +26,13 @@ import ( "runtime" "strconv" "strings" + "sync/atomic" "testing" "text/template" "time" "github.com/stretchr/testify/assert" - "github.com/elastic/beats/v7/libbeat/common/atomic" "github.com/elastic/beats/v7/winlogbeat/sys/winevent" "github.com/elastic/elastic-agent-libs/logp" ) @@ -297,7 +297,7 @@ func BenchmarkRenderer(b *testing.B) { defer itr.Close() defer r.Close() - count := atomic.NewUint64(0) + count := atomic.Uint64{} start := time.Now() b.ResetTimer() @@ -314,7 +314,7 @@ func BenchmarkRenderer(b *testing.B) { b.Fatal(err) } - count.Inc() + count.Add(1) } elapsed := time.Since(start) @@ -326,7 +326,7 @@ func BenchmarkRenderer(b *testing.B) { defer itr.Close() defer r.Close() - count := atomic.NewUint64(0) + var count atomic.Uint64 start := time.Now() b.ResetTimer() @@ -343,7 +343,7 @@ func BenchmarkRenderer(b *testing.B) { if err != nil { b.Fatal(err) } - count.Inc() + count.Add(1) } }) diff --git a/x-pack/filebeat/input/awss3/metrics_test.go b/x-pack/filebeat/input/awss3/metrics_test.go index e153d321e9f..33d3b9a513b 100644 --- a/x-pack/filebeat/input/awss3/metrics_test.go +++ b/x-pack/filebeat/input/awss3/metrics_test.go @@ -5,12 +5,12 @@ package awss3 import ( + "sync/atomic" "testing" "time" "github.com/stretchr/testify/assert" - "github.com/elastic/beats/v7/libbeat/common/atomic" "github.com/elastic/elastic-agent-libs/monitoring" ) diff --git a/x-pack/filebeat/input/entityanalytics/internal/kvstore/tracker.go b/x-pack/filebeat/input/entityanalytics/internal/kvstore/tracker.go index b18229b7795..71abb10d137 100644 --- a/x-pack/filebeat/input/entityanalytics/internal/kvstore/tracker.go +++ b/x-pack/filebeat/input/entityanalytics/internal/kvstore/tracker.go @@ -6,10 +6,10 @@ package kvstore import ( "context" + "sync/atomic" "github.com/elastic/beats/v7/libbeat/beat" "github.com/elastic/beats/v7/libbeat/common/acker" - "github.com/elastic/beats/v7/libbeat/common/atomic" ) // TxTracker implements a transaction tracker. Individual beat events which @@ -17,20 +17,20 @@ import ( // ACK-ed, the pending count is decremented (see NewTxACKHandler). Calling Wait // will block until all events are ACK-ed or the parent context is cancelled. type TxTracker struct { - pending atomic.Int + pending atomic.Int64 ctx context.Context cancel context.CancelFunc } // Add increments the pending count. func (t *TxTracker) Add() { - t.pending.Inc() + t.pending.Add(1) } // Ack decrements the pending count. If pending goes to zero, then the // context on TxTracker is cancelled. func (t *TxTracker) Ack() { - if t.pending.Dec() == 0 { + if t.pending.Add(-1) == 0 { t.cancel() } } diff --git a/x-pack/filebeat/input/entityanalytics/internal/kvstore/tracker_test.go b/x-pack/filebeat/input/entityanalytics/internal/kvstore/tracker_test.go index 7b452e21ae8..7741fa1e595 100644 --- a/x-pack/filebeat/input/entityanalytics/internal/kvstore/tracker_test.go +++ b/x-pack/filebeat/input/entityanalytics/internal/kvstore/tracker_test.go @@ -15,7 +15,7 @@ import ( func TestTxTracker_Ack(t *testing.T) { txTracker := NewTxTracker(context.Background()) - txTracker.pending.Inc() + txTracker.pending.Add(1) txTracker.Ack() @@ -25,9 +25,9 @@ func TestTxTracker_Ack(t *testing.T) { func TestTxTracker_Add(t *testing.T) { txTracker := NewTxTracker(context.Background()) - require.Equal(t, 0, txTracker.pending.Load()) + require.Equal(t, int64(0), txTracker.pending.Load()) txTracker.Add() - require.Equal(t, 1, txTracker.pending.Load()) + require.Equal(t, int64(1), txTracker.pending.Load()) } func TestTxTracker_Wait(t *testing.T) { @@ -43,7 +43,7 @@ func TestTxACKHandler(t *testing.T) { handler := NewTxACKHandler() txTracker.Add() - require.Equal(t, 1, txTracker.pending.Load()) + require.Equal(t, int64(1), txTracker.pending.Load()) handler.AddEvent(beat.Event{ Private: txTracker, @@ -63,7 +63,7 @@ func TestTxACKHandler(t *testing.T) { handler := NewTxACKHandler() txTracker.Add() - require.Equal(t, 1, txTracker.pending.Load()) + require.Equal(t, int64(1), txTracker.pending.Load()) handler.AddEvent(beat.Event{ Private: txTracker, @@ -71,6 +71,6 @@ func TestTxACKHandler(t *testing.T) { txTracker.Wait() - require.Equal(t, 1, txTracker.pending.Load()) + require.Equal(t, int64(1), txTracker.pending.Load()) }) } diff --git a/x-pack/filebeat/input/entityanalytics/internal/kvstore/transaction.go b/x-pack/filebeat/input/entityanalytics/internal/kvstore/transaction.go index 7f32429a4e9..c62155d27fb 100644 --- a/x-pack/filebeat/input/entityanalytics/internal/kvstore/transaction.go +++ b/x-pack/filebeat/input/entityanalytics/internal/kvstore/transaction.go @@ -8,10 +8,9 @@ import ( "encoding/json" "errors" "fmt" + "sync/atomic" "go.etcd.io/bbolt" - - "github.com/elastic/beats/v7/libbeat/common/atomic" ) var ( @@ -126,7 +125,7 @@ func (t *Transaction) Delete(bucket, key []byte) error { // Commit will write any changes to disk. For read-only transactions, calling // Commit will route to Rollback. func (t *Transaction) Commit() error { - if !t.closed.CAS(false, true) { + if !t.closed.CompareAndSwap(false, true) { return nil } if !t.writeable { @@ -138,7 +137,7 @@ func (t *Transaction) Commit() error { // Rollback closes the transaction. For write transactions, all updates made // within the transaction will be discarded. func (t *Transaction) Rollback() error { - if !t.closed.CAS(false, true) { + if !t.closed.CompareAndSwap(false, true) { return nil } return t.tx.Rollback() diff --git a/x-pack/filebeat/input/gcppubsub/pubsub_test.go b/x-pack/filebeat/input/gcppubsub/pubsub_test.go index 7981a3ee772..16fdbf1ebbd 100644 --- a/x-pack/filebeat/input/gcppubsub/pubsub_test.go +++ b/x-pack/filebeat/input/gcppubsub/pubsub_test.go @@ -12,6 +12,7 @@ import ( "os" "strconv" "sync" + "sync/atomic" "testing" "time" @@ -23,7 +24,6 @@ import ( "github.com/elastic/beats/v7/filebeat/channel" "github.com/elastic/beats/v7/filebeat/input" "github.com/elastic/beats/v7/libbeat/beat" - "github.com/elastic/beats/v7/libbeat/common/atomic" "github.com/elastic/beats/v7/libbeat/tests/compose" "github.com/elastic/beats/v7/libbeat/tests/resources" conf "github.com/elastic/elastic-agent-libs/config" @@ -247,6 +247,7 @@ func runTestWithACKer(t *testing.T, cfg *conf.C, onEvent eventHandler, run func( if err != nil { t.Fatal(err) } + //nolint:errcheck // ignore pubsubInput := in.(*pubsubInput) defer pubsubInput.Stop() @@ -421,13 +422,14 @@ func TestRunStop(t *testing.T) { func TestEndToEndACK(t *testing.T) { cfg := defaultTestConfig() - var count atomic.Int + var count atomic.Int64 seen := make(map[string]struct{}) // ACK every other message halfAcker := func(ev beat.Event, clientConfig beat.ClientConfig) bool { + //nolint:errcheck // ignore msg := ev.Private.(*pubsub.Message) seen[msg.ID] = struct{}{} - if count.Inc()&1 != 0 { + if count.Add(1)&1 != 0 { // Nack will result in the Message being redelivered more quickly than if it were allowed to expire. msg.Nack() return false @@ -453,6 +455,7 @@ func TestEndToEndACK(t *testing.T) { assert.Len(t, events, len(seen)) got := make(map[string]struct{}) for _, ev := range events { + //nolint:errcheck // ignore msg := ev.Private.(*pubsub.Message) got[msg.ID] = struct{}{} } diff --git a/x-pack/filebeat/input/netflow/decoder/atomic/bool.go b/x-pack/filebeat/input/netflow/decoder/atomic/bool.go deleted file mode 100644 index b294cc6c395..00000000000 --- a/x-pack/filebeat/input/netflow/decoder/atomic/bool.go +++ /dev/null @@ -1,30 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package atomic - -import "sync/atomic" - -type Bool struct { - value uint32 -} - -func (b *Bool) Store(value bool) { - atomic.StoreUint32(&b.value, encodeBool(value)) -} - -func (b *Bool) CAS(old bool, new bool) (swapped bool) { - return atomic.CompareAndSwapUint32(&b.value, encodeBool(old), encodeBool(new)) -} - -func (b *Bool) Load() (value bool) { - return atomic.LoadUint32(&b.value) != 0 -} - -func encodeBool(value bool) (result uint32) { - if value { - result = 1 - } - return -} diff --git a/x-pack/filebeat/input/netflow/decoder/v9/session.go b/x-pack/filebeat/input/netflow/decoder/v9/session.go index 492576f6b96..e72fa1ab80a 100644 --- a/x-pack/filebeat/input/netflow/decoder/v9/session.go +++ b/x-pack/filebeat/input/netflow/decoder/v9/session.go @@ -8,9 +8,9 @@ import ( "log" "net" "sync" + "sync/atomic" "time" - "github.com/elastic/beats/v7/x-pack/filebeat/input/netflow/decoder/atomic" "github.com/elastic/beats/v7/x-pack/filebeat/input/netflow/decoder/config" "github.com/elastic/beats/v7/x-pack/filebeat/input/netflow/decoder/template" ) @@ -83,7 +83,7 @@ func (s *SessionState) ExpireTemplates() (alive int, removed int) { var toDelete []TemplateKey s.mutex.RLock() for id, template := range s.Templates { - if !template.Delete.CAS(false, true) { + if !template.Delete.CompareAndSwap(false, true) { toDelete = append(toDelete, id) } } @@ -183,7 +183,7 @@ func (m *SessionMap) cleanup() (aliveSession int, removedSession int, aliveTempl a, r := session.ExpireTemplates() aliveTemplates += a removedTemplates += r - if !session.Delete.CAS(false, true) { + if !session.Delete.CompareAndSwap(false, true) { toDelete = append(toDelete, key) } } diff --git a/x-pack/heartbeat/monitors/browser/synthexec/execmultiplexer.go b/x-pack/heartbeat/monitors/browser/synthexec/execmultiplexer.go index f3684398a51..fe384ae15b2 100644 --- a/x-pack/heartbeat/monitors/browser/synthexec/execmultiplexer.go +++ b/x-pack/heartbeat/monitors/browser/synthexec/execmultiplexer.go @@ -5,12 +5,10 @@ package synthexec -import ( - "github.com/elastic/beats/v7/libbeat/common/atomic" -) +import "sync/atomic" type ExecMultiplexer struct { - eventCounter *atomic.Int + eventCounter *atomic.Int64 synthEvents chan *SynthEvent done chan struct{} } @@ -27,7 +25,7 @@ func (e *ExecMultiplexer) writeSynthEvent(se *SynthEvent) { if se.Type == JourneyStart { e.eventCounter.Store(-1) } - se.index = e.eventCounter.Inc() + se.index = int(e.eventCounter.Add(1)) e.synthEvents <- se } @@ -48,8 +46,10 @@ func (e *ExecMultiplexer) Wait() { } func NewExecMultiplexer() *ExecMultiplexer { + c := &atomic.Int64{} + c.Store(-1) // Start from -1 so first call to Inc returns 0 return &ExecMultiplexer{ - eventCounter: atomic.NewInt(-1), // Start from -1 so first call to Inc returns 0 + eventCounter: c, synthEvents: make(chan *SynthEvent), done: make(chan struct{}), } diff --git a/x-pack/metricbeat/module/cloudfoundry/v1.go b/x-pack/metricbeat/module/cloudfoundry/v1.go index f03f6a98ebb..86610e0d6cb 100644 --- a/x-pack/metricbeat/module/cloudfoundry/v1.go +++ b/x-pack/metricbeat/module/cloudfoundry/v1.go @@ -7,7 +7,8 @@ package cloudfoundry import ( - "github.com/elastic/beats/v7/libbeat/common/atomic" + "sync/atomic" + "github.com/elastic/beats/v7/metricbeat/mb" cfcommon "github.com/elastic/beats/v7/x-pack/libbeat/common/cloudfoundry" "github.com/elastic/elastic-agent-libs/logp" @@ -29,7 +30,6 @@ func newModuleV1(base mb.BaseModule, hub CloudfoundryHub, log *logp.Logger) (*Mo m := ModuleV1{ BaseModule: base, log: log, - running: atomic.MakeBool(false), } consumer, err := hub.DopplerConsumer(cfcommon.DopplerCallbacks{ Metric: m.callback, @@ -83,7 +83,7 @@ func (m *ModuleV1) callback(event cfcommon.Event) { // run ensures that the module is running with the passed subscription func (m *ModuleV1) run(s subscription) { - if !m.running.CAS(false, true) { + if !m.running.CompareAndSwap(false, true) { // Module is already running, queue subscription for current dispatcher. m.subscriptions <- s return From fd8107420d2c063a3f3a0e382e9d4b02006c4e64 Mon Sep 17 00:00:00 2001 From: ShourieG Date: Wed, 11 Dec 2024 08:02:42 +0530 Subject: [PATCH 6/8] [filebeat][streaming] - Added support for TLS & forward proxy configs for websockets (#41934) --- CHANGELOG.next.asciidoc | 1 + .../docs/inputs/input-streaming.asciidoc | 22 ++ x-pack/filebeat/input/streaming/config.go | 11 +- .../filebeat/input/streaming/input_manager.go | 2 +- x-pack/filebeat/input/streaming/input_test.go | 249 ++++++++++++++++++ .../input/streaming/testdata/certs/ca.crt | 21 ++ .../input/streaming/testdata/certs/cert.pem | 21 ++ .../input/streaming/testdata/certs/key.pem | 28 ++ x-pack/filebeat/input/streaming/websocket.go | 53 +++- 9 files changed, 402 insertions(+), 6 deletions(-) create mode 100644 x-pack/filebeat/input/streaming/testdata/certs/ca.crt create mode 100644 x-pack/filebeat/input/streaming/testdata/certs/cert.pem create mode 100644 x-pack/filebeat/input/streaming/testdata/certs/key.pem diff --git a/CHANGELOG.next.asciidoc b/CHANGELOG.next.asciidoc index bb6c4df0f62..dd4f19be335 100644 --- a/CHANGELOG.next.asciidoc +++ b/CHANGELOG.next.asciidoc @@ -360,6 +360,7 @@ https://github.com/elastic/beats/compare/v8.8.1\...main[Check the HEAD diff] - Add evaluation state dump debugging option to CEL input. {pull}41335[41335] - Added support for retry configuration in GCS input. {issue}11580[11580] {pull}41862[41862] - Improve S3 polling mode states registry when using list prefix option. {pull}41869[41869] +- Add support for SSL and Proxy configurations for websoket type in streaming input. {pull}41934[41934] - AWS S3 input registry cleanup for untracked s3 objects. {pull}41694[41694] - The environment variable `BEATS_AZURE_EVENTHUB_INPUT_TRACING_ENABLED: true` enables internal logs tracer for the azure-eventhub input. {issue}41931[41931] {pull}41932[41932] diff --git a/x-pack/filebeat/docs/inputs/input-streaming.asciidoc b/x-pack/filebeat/docs/inputs/input-streaming.asciidoc index b80deda9c77..9a6f67e5bc4 100644 --- a/x-pack/filebeat/docs/inputs/input-streaming.asciidoc +++ b/x-pack/filebeat/docs/inputs/input-streaming.asciidoc @@ -349,6 +349,28 @@ The minimum time to wait between retries. This ensures that retries are spaced o The maximum time to wait between retries. This prevents the retry mechanism from becoming too slow, ensuring that the client does not wait indefinitely between retries. This is crucial in systems where timeouts or user experience are critical. For example, `wait_max` might be set to 10 seconds, meaning that even if the calculated backoff is greater than this, the client will wait at most 10 seconds before retrying. +[float] +=== `timeout` +Timeout is the maximum amount of time the websocket dialer will wait for a connection to be established. The default value is `180` seconds. + +[float] +==== `proxy_url` +This specifies the forward proxy URL to use for the connection. The `proxy_url` configuration is optional and can be used to configure the proxy settings for the connection. The `proxy_url` default value is set by `http.ProxyFromEnvironment` which reads the `HTTP_PROXY`, `HTTPS_PROXY`, and `NO_PROXY` environment variables. + +[float] +==== `proxy_headers` +This specifies the headers to be sent to the proxy server. The `proxy_headers` configuration is optional and can be used to configure the headers to be sent to the proxy server. + +[float] +==== `ssl` +This specifies the SSL configuration for the connection. The `ssl` configuration is optional and can be used to configure the SSL settings for the connection. The `ssl` configuration has the following subfields: + + - `certificate_authorities`: A list of root certificates to use for verifying the server's certificate. + - `certificate`: The (PEM encoded) certificate to use for client authentication. + - `key`: The (PEM encoded) private key to use for client authentication. + +If this is a self-signed certificate, the `certificate_authorities` field should be set to the certificate itself. + [float] === Metrics diff --git a/x-pack/filebeat/input/streaming/config.go b/x-pack/filebeat/input/streaming/config.go index 67ee6e1eb31..6ccaf0c7349 100644 --- a/x-pack/filebeat/input/streaming/config.go +++ b/x-pack/filebeat/input/streaming/config.go @@ -41,9 +41,8 @@ type config struct { Redact *redact `config:"redact"` // Retry is the configuration for retrying failed connections. Retry *retry `config:"retry"` - + // Transport is the common the transport config. Transport httpcommon.HTTPTransportSettings `config:",inline"` - // CrowdstrikeAppID is the value used to set the // appId request parameter in the FalconHose stream // discovery request. @@ -166,3 +165,11 @@ func checkURLScheme(c config) error { return fmt.Errorf("unknown stream type: %s", c.Type) } } + +func defaultConfig() config { + return config{ + Transport: httpcommon.HTTPTransportSettings{ + Timeout: 180 * time.Second, + }, + } +} diff --git a/x-pack/filebeat/input/streaming/input_manager.go b/x-pack/filebeat/input/streaming/input_manager.go index f20b867755b..c685452c34f 100644 --- a/x-pack/filebeat/input/streaming/input_manager.go +++ b/x-pack/filebeat/input/streaming/input_manager.go @@ -34,7 +34,7 @@ func NewInputManager(log *logp.Logger, store inputcursor.StateStore) InputManage } func cursorConfigure(cfg *conf.C) ([]inputcursor.Source, inputcursor.Input, error) { - src := &source{cfg: config{}} + src := &source{cfg: defaultConfig()} if err := cfg.Unpack(&src.cfg); err != nil { return nil, nil, err } diff --git a/x-pack/filebeat/input/streaming/input_test.go b/x-pack/filebeat/input/streaming/input_test.go index 6d382bdf664..c11784ea3db 100644 --- a/x-pack/filebeat/input/streaming/input_test.go +++ b/x-pack/filebeat/input/streaming/input_test.go @@ -6,6 +6,7 @@ package streaming import ( "context" + "crypto/tls" "errors" "fmt" "net/http" @@ -41,6 +42,7 @@ type WebSocketHandler func(*testing.T, *websocket.Conn, []string) var inputTests = []struct { name string server func(*testing.T, WebSocketHandler, map[string]interface{}, []string) + proxyServer func(*testing.T, WebSocketHandler, map[string]interface{}, []string) *httptest.Server handler WebSocketHandler config map[string]interface{} response []string @@ -450,6 +452,140 @@ var inputTests = []struct { }, wantErr: fmt.Errorf("failed to establish WebSocket connection after 2 attempts with error websocket: bad handshake"), }, + { + name: "single_event_tls", + server: webSocketServerWithTLS(httptest.NewUnstartedServer), + handler: defaultHandler, + config: map[string]interface{}{ + "program": ` + bytes(state.response).decode_json().as(inner_body,{ + "events": [inner_body], + })`, + "ssl": map[string]interface{}{ + "enabled": true, + "certificate_authorities": []string{"testdata/certs/ca.crt"}, + "certificate": "testdata/certs/cert.pem", + "key": "testdata/certs/key.pem", + }, + }, + response: []string{` + { + "pps": { + "agent": "example.proofpoint.com", + "cid": "mmeng_uivm071" + }, + "ts": "2017-08-17T14:54:12.949180-07:00", + "data": "2017-08-17T14:54:12.949180-07:00 example sendmail[30641]:v7HLqYbx029423: to=/dev/null, ctladdr= (8/0),delay=00:00:00, xdelay=00:00:00, mailer=*file*, tls_verify=NONE, pri=35342,dsn=2.0.0, stat=Sent", + "sm": { + "tls": { + "verify": "NONE" + }, + "stat": "Sent", + "qid": "v7HLqYbx029423", + "dsn": "2.0.0", + "mailer": "*file*", + "to": [ + "/dev/null" + ], + "ctladdr": " (8/0)", + "delay": "00:00:00", + "xdelay": "00:00:00", + "pri": 35342 + }, + "id": "ZeYGULpZmL5N0151HN1OyA" + }`}, + want: []map[string]interface{}{ + { + "pps": map[string]interface{}{ + "agent": "example.proofpoint.com", + "cid": "mmeng_uivm071", + }, + "ts": "2017-08-17T14:54:12.949180-07:00", + "data": "2017-08-17T14:54:12.949180-07:00 example sendmail[30641]:v7HLqYbx029423: to=/dev/null, ctladdr= (8/0),delay=00:00:00, xdelay=00:00:00, mailer=*file*, tls_verify=NONE, pri=35342,dsn=2.0.0, stat=Sent", + "sm": map[string]interface{}{ + "tls": map[string]interface{}{ + "verify": "NONE", + }, + "stat": "Sent", + "qid": "v7HLqYbx029423", + "dsn": "2.0.0", + "mailer": "*file*", + "to": []interface{}{ + "/dev/null", + }, + "ctladdr": " (8/0)", + "delay": "00:00:00", + "xdelay": "00:00:00", + "pri": float64(35342), + }, + "id": "ZeYGULpZmL5N0151HN1OyA", + }, + }, + }, + { + name: "basic_proxy_forwarding", + proxyServer: newWebSocketProxyTestServer, + handler: defaultHandler, + config: map[string]interface{}{ + "program": ` + bytes(state.response).decode_json().as(inner_body,{ + "events": [inner_body], + })`, + }, + response: []string{` + { + "pps": { + "agent": "example.proofpoint.com", + "cid": "mmeng_uivm071" + }, + "ts": "2017-08-17T14:54:12.949180-07:00", + "data": "2017-08-17T14:54:12.949180-07:00 example sendmail[30641]:v7HLqYbx029423: to=/dev/null, ctladdr= (8/0),delay=00:00:00, xdelay=00:00:00, mailer=*file*, tls_verify=NONE, pri=35342,dsn=2.0.0, stat=Sent", + "sm": { + "tls": { + "verify": "NONE" + }, + "stat": "Sent", + "qid": "v7HLqYbx029423", + "dsn": "2.0.0", + "mailer": "*file*", + "to": [ + "/dev/null" + ], + "ctladdr": " (8/0)", + "delay": "00:00:00", + "xdelay": "00:00:00", + "pri": 35342 + }, + "id": "ZeYGULpZmL5N0151HN1OyA" + }`}, + want: []map[string]interface{}{ + { + "pps": map[string]interface{}{ + "agent": "example.proofpoint.com", + "cid": "mmeng_uivm071", + }, + "ts": "2017-08-17T14:54:12.949180-07:00", + "data": "2017-08-17T14:54:12.949180-07:00 example sendmail[30641]:v7HLqYbx029423: to=/dev/null, ctladdr= (8/0),delay=00:00:00, xdelay=00:00:00, mailer=*file*, tls_verify=NONE, pri=35342,dsn=2.0.0, stat=Sent", + "sm": map[string]interface{}{ + "tls": map[string]interface{}{ + "verify": "NONE", + }, + "stat": "Sent", + "qid": "v7HLqYbx029423", + "dsn": "2.0.0", + "mailer": "*file*", + "to": []interface{}{ + "/dev/null", + }, + "ctladdr": " (8/0)", + "delay": "00:00:00", + "xdelay": "00:00:00", + "pri": float64(35342), + }, + "id": "ZeYGULpZmL5N0151HN1OyA", + }, + }, + }, } var urlEvalTests = []struct { @@ -560,6 +696,9 @@ func TestInput(t *testing.T) { if test.server != nil { test.server(t, test.handler, test.config, test.response) } + if test.proxyServer != nil { + test.proxyServer(t, test.handler, test.config, test.response) + } cfg := conf.MustNewConfigFrom(test.config) @@ -771,6 +910,46 @@ func webSocketServerWithRetry(serve func(http.Handler) *httptest.Server) func(*t } } +// webSocketServerWithTLS simulates a WebSocket server with TLS based authentication. +func webSocketServerWithTLS(serve func(http.Handler) *httptest.Server) func(*testing.T, WebSocketHandler, map[string]interface{}, []string) { + return func(t *testing.T, handler WebSocketHandler, config map[string]interface{}, response []string) { + server := serve(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + upgrader := websocket.Upgrader{ + CheckOrigin: func(r *http.Request) bool { + return true + }, + } + + conn, err := upgrader.Upgrade(w, r, nil) + if err != nil { + t.Fatalf("error upgrading connection to WebSocket: %v", err) + return + } + + handler(t, conn, response) + })) + //nolint:gosec // there is no need to use a secure cert for testing + server.TLS = &tls.Config{ + Certificates: []tls.Certificate{generateSelfSignedCert(t)}, + } + server.StartTLS() + + if config["url"] == nil { + config["url"] = "ws" + server.URL[4:] + } + t.Cleanup(server.Close) + } +} + +// generateSelfSignedCert returns a self-signed certificate for testing purposes based on the dummy certs in the testdata directory +func generateSelfSignedCert(t *testing.T) tls.Certificate { + cert, err := tls.LoadX509KeyPair("testdata/certs/cert.pem", "testdata/certs/key.pem") + if err != nil { + t.Fatalf("failed to generate self-signed cert: %v", err) + } + return cert +} + // defaultHandler is a default handler for WebSocket connections. func defaultHandler(t *testing.T, conn *websocket.Conn, response []string) { for _, r := range response { @@ -780,3 +959,73 @@ func defaultHandler(t *testing.T, conn *websocket.Conn, response []string) { } } } + +// webSocketTestServer creates a WebSocket target server that communicates with the proxy handler. +func webSocketTestServer(t *testing.T, handler WebSocketHandler, response []string) *httptest.Server { + return httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + upgrader := websocket.Upgrader{ + CheckOrigin: func(r *http.Request) bool { + return true + }, + } + conn, err := upgrader.Upgrade(w, r, nil) + if err != nil { + t.Fatalf("failed to upgrade WebSocket connection: %v", err) + return + } + handler(t, conn, response) + })) +} + +// webSocketProxyHandler forwards WebSocket connections to the target server. +// +//nolint:errcheck //we can safely ignore errors checks here +func webSocketProxyHandler(targetURL string) http.HandlerFunc { + return func(w http.ResponseWriter, r *http.Request) { + defer r.Response.Body.Close() + //nolint:bodyclose // we can ignore the body close here + targetConn, _, err := websocket.DefaultDialer.Dial(targetURL, nil) + if err != nil { + http.Error(w, "failed to connect to backend WebSocket server", http.StatusBadGateway) + return + } + defer targetConn.Close() + + upgrader := websocket.Upgrader{ + CheckOrigin: func(r *http.Request) bool { + return true + }, + } + clientConn, err := upgrader.Upgrade(w, r, nil) + if err != nil { + http.Error(w, "failed to upgrade client connection", http.StatusInternalServerError) + return + } + defer clientConn.Close() + // forward messages between client and target server + go func() { + for { + messageType, message, err := targetConn.ReadMessage() + if err != nil { + break + } + clientConn.WriteMessage(messageType, message) + } + }() + for { + messageType, message, err := clientConn.ReadMessage() + if err != nil { + break + } + targetConn.WriteMessage(messageType, message) + } + } +} + +// newWebSocketProxyTestServer creates a proxy server forwarding WebSocket traffic. +func newWebSocketProxyTestServer(t *testing.T, handler WebSocketHandler, config map[string]interface{}, response []string) *httptest.Server { + backendServer := webSocketTestServer(t, handler, response) + config["url"] = "ws" + backendServer.URL[4:] + config["proxy_url"] = "ws" + backendServer.URL[4:] + return httptest.NewServer(webSocketProxyHandler(config["url"].(string))) +} diff --git a/x-pack/filebeat/input/streaming/testdata/certs/ca.crt b/x-pack/filebeat/input/streaming/testdata/certs/ca.crt new file mode 100644 index 00000000000..43e187f1367 --- /dev/null +++ b/x-pack/filebeat/input/streaming/testdata/certs/ca.crt @@ -0,0 +1,21 @@ +-----BEGIN CERTIFICATE----- +MIIDbTCCAlWgAwIBAgIUS/rm8sWDc2a+eD9L+q+9XQpBa5MwDQYJKoZIhvcNAQEL +BQAwRTELMAkGA1UEBhMCQVUxEzARBgNVBAgMClNvbWUtU3RhdGUxITAfBgNVBAoM +GEludGVybmV0IFdpZGdpdHMgUHR5IEx0ZDAgFw0yNDEyMDUxMjM4NThaGA8yMTI0 +MTExMTEyMzg1OFowRTELMAkGA1UEBhMCQVUxEzARBgNVBAgMClNvbWUtU3RhdGUx +ITAfBgNVBAoMGEludGVybmV0IFdpZGdpdHMgUHR5IEx0ZDCCASIwDQYJKoZIhvcN +AQEBBQADggEPADCCAQoCggEBALhEaFVqFuYwSwH4GHhMeqhilC+sWXKaQP8QmaH7 +HWRST8Ko6YTT9NixUL4Qs5OmzCQFavRN9qtEo4wtqCJBOEyXQG1wAHuLWIY+KOCB +twUg8fP+uYaYUOQOYNLkBz7SLlejuZYTyGxepIkc+UeJRcOE36anIPHpc2KSr3Hm +vKJxZUVpQEbJvQ7pe7+iLL4jSOfzpQNcV9S/bzTo6taZXuo+ryEPlshkU/ME5VCN +LFrU3AW2fzKW0Xa/skkW5izCiAU8KNEy84UQM6aZkJfFi9O394i97sGgYg+q36XL +sXbZ+sCXHI3CGx+pwOx0h7S8n7iJJ7BbmwM6QuLFF6bFYkkCAwEAAaNTMFEwHQYD +VR0OBBYEFEHtfvey8SdncMr7VDqA2YhtEiGYMB8GA1UdIwQYMBaAFEHtfvey8Sdn +cMr7VDqA2YhtEiGYMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQELBQADggEB +AKFcAeh9yhIbkkxvXl6ebmLcj817NVjhpcvDZlKP2MVu+w/h70w+JwBktLUlZlXd +UNkKEWZyRvrdmY+YN6rwY/QI75N17bcmDWy6QnNlVJF0AJkBSdbKonCgHrZm7K25 +TOKpj0QF8l7k9wr5FWHHcBw/vFF9cGZ5TO4HbnI25N/cEKgdzZFEVA5Y/Rv7GIGU +COjJG20Cr2HIKvVYoyWvN6sL7+gbzUMyjvQyGMCT7YoIqscUfrUU+T46QaOLAKa3 +z91Obfmv6uTO/rsieoxVWVJ35GeHeNJkAPkr7Z1sWIrreJ/3WsecWuPPEDNDXiSV +5h0bTbbPOyEIe5ydEIbr5kA= +-----END CERTIFICATE----- diff --git a/x-pack/filebeat/input/streaming/testdata/certs/cert.pem b/x-pack/filebeat/input/streaming/testdata/certs/cert.pem new file mode 100644 index 00000000000..43e187f1367 --- /dev/null +++ b/x-pack/filebeat/input/streaming/testdata/certs/cert.pem @@ -0,0 +1,21 @@ +-----BEGIN CERTIFICATE----- +MIIDbTCCAlWgAwIBAgIUS/rm8sWDc2a+eD9L+q+9XQpBa5MwDQYJKoZIhvcNAQEL +BQAwRTELMAkGA1UEBhMCQVUxEzARBgNVBAgMClNvbWUtU3RhdGUxITAfBgNVBAoM +GEludGVybmV0IFdpZGdpdHMgUHR5IEx0ZDAgFw0yNDEyMDUxMjM4NThaGA8yMTI0 +MTExMTEyMzg1OFowRTELMAkGA1UEBhMCQVUxEzARBgNVBAgMClNvbWUtU3RhdGUx +ITAfBgNVBAoMGEludGVybmV0IFdpZGdpdHMgUHR5IEx0ZDCCASIwDQYJKoZIhvcN +AQEBBQADggEPADCCAQoCggEBALhEaFVqFuYwSwH4GHhMeqhilC+sWXKaQP8QmaH7 +HWRST8Ko6YTT9NixUL4Qs5OmzCQFavRN9qtEo4wtqCJBOEyXQG1wAHuLWIY+KOCB +twUg8fP+uYaYUOQOYNLkBz7SLlejuZYTyGxepIkc+UeJRcOE36anIPHpc2KSr3Hm +vKJxZUVpQEbJvQ7pe7+iLL4jSOfzpQNcV9S/bzTo6taZXuo+ryEPlshkU/ME5VCN +LFrU3AW2fzKW0Xa/skkW5izCiAU8KNEy84UQM6aZkJfFi9O394i97sGgYg+q36XL +sXbZ+sCXHI3CGx+pwOx0h7S8n7iJJ7BbmwM6QuLFF6bFYkkCAwEAAaNTMFEwHQYD +VR0OBBYEFEHtfvey8SdncMr7VDqA2YhtEiGYMB8GA1UdIwQYMBaAFEHtfvey8Sdn +cMr7VDqA2YhtEiGYMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQELBQADggEB +AKFcAeh9yhIbkkxvXl6ebmLcj817NVjhpcvDZlKP2MVu+w/h70w+JwBktLUlZlXd +UNkKEWZyRvrdmY+YN6rwY/QI75N17bcmDWy6QnNlVJF0AJkBSdbKonCgHrZm7K25 +TOKpj0QF8l7k9wr5FWHHcBw/vFF9cGZ5TO4HbnI25N/cEKgdzZFEVA5Y/Rv7GIGU +COjJG20Cr2HIKvVYoyWvN6sL7+gbzUMyjvQyGMCT7YoIqscUfrUU+T46QaOLAKa3 +z91Obfmv6uTO/rsieoxVWVJ35GeHeNJkAPkr7Z1sWIrreJ/3WsecWuPPEDNDXiSV +5h0bTbbPOyEIe5ydEIbr5kA= +-----END CERTIFICATE----- diff --git a/x-pack/filebeat/input/streaming/testdata/certs/key.pem b/x-pack/filebeat/input/streaming/testdata/certs/key.pem new file mode 100644 index 00000000000..1b6ce6bade3 --- /dev/null +++ b/x-pack/filebeat/input/streaming/testdata/certs/key.pem @@ -0,0 +1,28 @@ +-----BEGIN PRIVATE KEY----- +MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQC4RGhVahbmMEsB ++Bh4THqoYpQvrFlymkD/EJmh+x1kUk/CqOmE0/TYsVC+ELOTpswkBWr0TfarRKOM +LagiQThMl0BtcAB7i1iGPijggbcFIPHz/rmGmFDkDmDS5Ac+0i5Xo7mWE8hsXqSJ +HPlHiUXDhN+mpyDx6XNikq9x5ryicWVFaUBGyb0O6Xu/oiy+I0jn86UDXFfUv280 +6OrWmV7qPq8hD5bIZFPzBOVQjSxa1NwFtn8yltF2v7JJFuYswogFPCjRMvOFEDOm +mZCXxYvTt/eIve7BoGIPqt+ly7F22frAlxyNwhsfqcDsdIe0vJ+4iSewW5sDOkLi +xRemxWJJAgMBAAECggEAQprvf5hWaKQiKLcN2UYDvCPN3qGUv3kEb24HqmZDjIS4 +MeuuZQXcZgtJ3TnaP0+2UHro2x/nPqcT2tKSCLe8aurtLeGjOwT2XafQTL52clMj +Qgfb9cvOyXBtDS3BdLKyb5lNtvK1qn5XSPyBGpuC7RZ1ZR7aKLcyrvnIkwpNOwXW +zH5F6pI6HAUPfgYcHfIkQ5kuPCRcvfmv6m9XLYlmiQNkReQ2fWtFF6517R6FGtZu +Z8F0pFz8VtIGQoamX9vEwQhYqBK67msl9gnKjyH3ONckkSRMVagXrwx9F5o+NeRD +IgDFnjH1HgLCXmeCa7BN+eYfGMZ24xisItD7XBzGtQKBgQDlmEncIgpkmtXZSvXs +r5i7epJDDcxC8/ZObsn3zI01t4nmI9+phu7a4fAA+AUP7+HFVdi22JcHDkHZ5J1a +93t+Tcc4yzXk8FovaavRRvJNXv3WhHvgNpe1tvgyMUc8p9QpfbHuafVhQN2qWivh +nnEWagBoguiXaXEIFRXFK6dt5wKBgQDNdZYQ4/Am7HNjI2vqmMccZxuSufUX0xxM +LuDY8UAsPbgRN8wqfY67xCdMztax5y15gF9UPw0hHMlk4m2J4lsqCqgRRWXnTser +rNAseZ1j7MZY0cKACRxvXNtPKmmHKvYHUEZkADT/HrhfZWIce7KEXaxdoGTkssPd +9/WbahLITwKBgFBa2VbTDyIg0sGHK8UXu/O5tWEEfj3clpLi0YsJq05mmzvRyGDT +2dr/gnlEVLk8Mp9XKU7tRQZyJff1vGDvBuiwng4xiP5EZLv9VuYa14jeuyaOHbDe +SoCNthYTCySedHHFDTYtHXVZN3t8raj8RAYdOWFal78OZ0H15zWnzqR3AoGBAJne +mxFxM3RjFpNDftmFq3BpA6xiGdzK3OFtJjUykAXR/xzd9chImfGjGG+cZAt9/3+E +FWCpi7KltWoZbUGbRPz6WB3/JC8Tv9OhK5JzTdz9ARqZlRmAOUxpdVEXiUqScQjP +JLhVs1rw7dF7wvtj5DDfWmwP6B+iha+huM24pfJfAoGAUYeJQ1XqEx+0+b6xrtCm +qxPiiGnJSi4J9CGaZRMTG5qFSQ5jCaWTJSWdiZJgyBMnmQsiuPacefAg91z/NjJC +xM0/sKLe/yPWP1UlwrCl1MDjMwIl/qtWiKXYXpY1qcOONLCFc6OASd1cTOtX/7Km +2g49JWZEY71f7DxLdcWfqWM= +-----END PRIVATE KEY----- diff --git a/x-pack/filebeat/input/streaming/websocket.go b/x-pack/filebeat/input/streaming/websocket.go index 0c8de94f5ad..8a78757f0e9 100644 --- a/x-pack/filebeat/input/streaming/websocket.go +++ b/x-pack/filebeat/input/streaming/websocket.go @@ -7,6 +7,7 @@ package streaming import ( "bytes" "context" + "crypto/tls" "errors" "fmt" "io" @@ -14,6 +15,7 @@ import ( "math/rand/v2" "net" "net/http" + "net/url" "strings" "time" @@ -22,6 +24,8 @@ import ( inputcursor "github.com/elastic/beats/v7/filebeat/input/v2/input-cursor" "github.com/elastic/elastic-agent-libs/logp" + "github.com/elastic/elastic-agent-libs/transport/httpcommon" + "github.com/elastic/elastic-agent-libs/transport/tlscommon" ) type websocketStream struct { @@ -220,14 +224,18 @@ func connectWebSocket(ctx context.Context, cfg config, url string, log *logp.Log var response *http.Response var err error headers := formHeader(cfg) - + dialer, err := createWebSocketDialer(cfg) + if err != nil { + return nil, nil, err + } if cfg.Retry != nil { retryConfig := cfg.Retry for attempt := 1; attempt <= retryConfig.MaxAttempts; attempt++ { - conn, response, err = websocket.DefaultDialer.DialContext(ctx, url, headers) + conn, response, err = dialer.DialContext(ctx, url, headers) if err == nil { return conn, response, nil } + //nolint:errorlint // it will never be a wrapped error at this point if err == websocket.ErrBadHandshake { log.Errorf("attempt %d: webSocket connection failed with bad handshake (status %d) retrying...\n", attempt, response.StatusCode) continue @@ -239,7 +247,7 @@ func connectWebSocket(ctx context.Context, cfg config, url string, log *logp.Log return nil, nil, fmt.Errorf("failed to establish WebSocket connection after %d attempts with error %w", retryConfig.MaxAttempts, err) } - return websocket.DefaultDialer.DialContext(ctx, url, headers) + return dialer.DialContext(ctx, url, headers) } // calculateWaitTime calculates the wait time for the next attempt based on the exponential backoff algorithm. @@ -269,3 +277,42 @@ func (s *websocketStream) Close() error { s.metrics.Close() return nil } + +func createWebSocketDialer(cfg config) (*websocket.Dialer, error) { + var tlsConfig *tls.Config + dialer := &websocket.Dialer{ + Proxy: http.ProxyFromEnvironment, + } + + // load proxy configuration if available + if cfg.Transport.Proxy.URL != nil { + var proxy func(*http.Request) (*url.URL, error) + proxyURL, err := httpcommon.NewProxyURIFromString(cfg.Transport.Proxy.URL.String()) + if err != nil { + return nil, fmt.Errorf("failed to parse proxy URL: %w", err) + } + // create a custom HTTP Transport with proxy configuration + proxyTransport := &http.Transport{ + Proxy: http.ProxyURL(proxyURL.URI()), + ProxyConnectHeader: cfg.Transport.Proxy.Headers.Headers(), + DialContext: (&net.Dialer{ + Timeout: cfg.Transport.Timeout, + }).DialContext, + } + dialer.NetDialContext = func(ctx context.Context, network, addr string) (net.Conn, error) { + return proxyTransport.DialContext(ctx, network, addr) + } + dialer.Proxy = proxy + } + // load TLS config if available + if cfg.Transport.TLS != nil { + TLSConfig, err := tlscommon.LoadTLSConfig(cfg.Transport.TLS) + if err != nil { + return nil, fmt.Errorf("failed to load TLS config: %w", err) + } + tlsConfig = TLSConfig.ToConfig() + dialer.TLSClientConfig = tlsConfig + } + + return dialer, nil +} From 002a22024daa5db9135dcd3877348e8f4861e1c0 Mon Sep 17 00:00:00 2001 From: ShourieG Date: Wed, 11 Dec 2024 12:02:15 +0530 Subject: [PATCH 7/8] [filebeat][gcs] - Removed bucket_timeout config option and replaced bucket context with parent program context (#41970) --- CHANGELOG.next.asciidoc | 1 + .../filebeat/docs/inputs/input-gcs.asciidoc | 51 ++++++------------- x-pack/filebeat/input/gcs/config.go | 12 ++--- x-pack/filebeat/input/gcs/input.go | 4 -- x-pack/filebeat/input/gcs/input_stateless.go | 1 - x-pack/filebeat/input/gcs/input_test.go | 3 -- x-pack/filebeat/input/gcs/job.go | 4 +- x-pack/filebeat/input/gcs/types.go | 1 - 8 files changed, 22 insertions(+), 55 deletions(-) diff --git a/CHANGELOG.next.asciidoc b/CHANGELOG.next.asciidoc index dd4f19be335..9c0fbc06447 100644 --- a/CHANGELOG.next.asciidoc +++ b/CHANGELOG.next.asciidoc @@ -451,6 +451,7 @@ https://github.com/elastic/beats/compare/v8.8.1\...main[Check the HEAD diff] *Filebeat* +- Removed `bucket_timeout` config option for GCS input and replaced bucket context with parent program context. {issue}41107[41107] {pull}41970[41970] *Heartbeat* diff --git a/x-pack/filebeat/docs/inputs/input-gcs.asciidoc b/x-pack/filebeat/docs/inputs/input-gcs.asciidoc index d85a7393440..a2de572bce0 100644 --- a/x-pack/filebeat/docs/inputs/input-gcs.asciidoc +++ b/x-pack/filebeat/docs/inputs/input-gcs.asciidoc @@ -23,6 +23,8 @@ The input can be configured to work with and without polling, though if polling 3. If any major error occurs which stops the main thread, the logs will be appropriately generated, describing said error. +**Config Option Removal Notice** : The `bucket_timeout` config option has been removed from the google cloud storage input. The intention behind this removal is to simplify the configuration and to make it more user friendly. The `bucket_timeout` option was confusing and had the potential to let users malconfigure the input, which could lead to unexpected behavior. The input now uses a more robust and efficient way to handle the bucket timeout internally. + [id="supported-types-gcs"] NOTE: Currently only `JSON` and `NDJSON` are supported object/file formats. Objects/files may be also be gzip compressed. "JSON credential keys" and "credential files" are supported authentication types. @@ -46,24 +48,22 @@ filebeat.inputs: max_workers: 3 poll: true poll_interval: 15s - bucket_timeout: 60s - name: gcs-test-old max_workers: 3 poll: true poll_interval: 10s - bucket_timeout: 30s ---- *Explanation :* This `configuration` given above describes a basic gcs config having two buckets named `gcs-test-new` and `gcs-test-old`. -Each of these buckets have their own attributes such as `name`, `max_workers`, `poll`, `poll_interval` and `bucket_timeout`. These attributes have detailed explanations +Each of these buckets have their own attributes such as `name`, `max_workers`, `poll` and `poll_interval`. These attributes have detailed explanations given <>. For now lets try to understand how this config works. For google cloud storage input to identify the files it needs to read and process, it will require the bucket names to be specified. We can have as -many buckets as we deem fit. We are also able to configure the attributes `max_workers`, `poll`, `poll_interval` and `bucket_timeout` at the root level, which will +many buckets as we deem fit. We are also able to configure the attributes `max_workers`, `poll` and `poll_interval` at the root level, which will then be applied to all buckets which do not specify any of these attributes explicitly. -NOTE: If the attributes `max_workers`, `poll`, `poll_interval` and `bucket_timeout` are specified at the root level, these can still be overridden at the bucket level with +NOTE: If the attributes `max_workers`, `poll` and `poll_interval` are specified at the root level, these can still be overridden at the bucket level with different values, thus offering extensive flexibility and customization. Examples <> show this behavior. On receiving this config the google cloud storage input will connect to the service and retrieve a `Storage Client` using the given `bucket_name` and @@ -71,7 +71,7 @@ On receiving this config the google cloud storage input will connect to the serv which will in turn use the `max_workers` value to initialize an in-memory worker pool (thread pool) with `3` `workers` available. Basically that equates to two instances of a worker pool, one per bucket, each having 3 workers. These `workers` will be responsible for performing `jobs` that process a file (in this case read and output the contents of a file). NOTE: The scheduler is responsible for scheduling jobs, and uses the `maximum available workers` in the pool, at each iteration, to decide the number of files to retrieve and -process. This keeps work distribution efficient. The scheduler uses `poll_interval` attribute value to decide how long to wait after each iteration. The `bucket_timeout` value is used to timeout calls to the bucket list api if it exceeds the given value. Each iteration consists of processing a certain number of files, decided by the `maximum available workers` value. +process. This keeps work distribution efficient. The scheduler uses `poll_interval` attribute value to decide how long to wait after each iteration. Each iteration consists of processing a certain number of files, decided by the `maximum available workers` value. *A Sample Response :-* ["source","json"] @@ -156,15 +156,14 @@ Now let's explore the configuration attributes a bit more elaborately. 3. <> 4. <> 5. <> - 6. <> - 7. <> - 8. <> - 9. <> - 10. <> - 11. <> - 12. <> - 13. <> - 14. <> + 6. <> + 7. <> + 8. <> + 9. <> + 10. <> + 11. <> + 12. <> + 13. <> [id="attrib-project-id"] @@ -195,9 +194,7 @@ specified, then the one that occurs first in the configuration will be used. [float] ==== `buckets` -This attribute contains the details about a specific bucket like `name`, `max_workers`, `poll`, `poll_interval` and `bucket_timeout`. The attribute `name` is specific to a -bucket as it describes the bucket name, while the fields `max_workers`, `poll`, `poll_interval` and `bucket_timeout` can exist both at the bucket level and the root level. -This attribute is internally represented as an array, so we can add as many buckets as we require. +This attribute contains the details about a specific bucket like `name`, `max_workers`, `poll` and `poll_interval`. The attribute `name` is specific to a bucket as it describes the bucket name, while the fields `max_workers`, `poll` and `poll_interval` can exist both at the bucket level and the root level. This attribute is internally represented as an array, so we can add as many buckets as we require. [id="attrib-bucket-name"] [float] @@ -205,14 +202,6 @@ This attribute is internally represented as an array, so we can add as many buck This is a specific subfield of a bucket. It specifies the bucket name. -[id="attrib-bucket-timeout"] -[float] -==== `bucket_timeout` - -This attribute defines the maximum amount of time after which a bucket operation will give and stop if no response is recieved (example: reading a file / listing a file). -It can be defined in the following formats : `{{x}}s`, `{{x}}m`, `{{x}}h`, here `s = seconds`, `m = minutes` and `h = hours`. The value `{{x}}` can be anything we wish. -If no value is specified for this, by default its initialized to `120 seconds`. This attribute can be specified both at the root level of the configuration as well at the bucket level. The bucket level values will always take priority and override the root level values if both are specified. The value of `bucket_timeout` that should be used depends on the size of the files and the network speed. If the timeout is too low, the input will not be able to read the file completely and `context_deadline_exceeded` errors will be seen in the logs. If the timeout is too high, the input will wait for a long time for the file to be read, which can cause the input to be slow. The ratio between the `bucket_timeout` and `poll_interval` should be considered while setting both the values. A low `poll_interval` and a very high `bucket_timeout` can cause resource utilization issues as schedule ops will be spawned every poll iteration. If previous poll ops are still running, this could result in concurrently running ops and so could cause a bottleneck over time. - [id="attrib-max_workers-gcs"] [float] ==== `max_workers` @@ -237,9 +226,7 @@ This attribute defines the maximum amount of time after which the internal sched defined in the following formats : `{{x}}s`, `{{x}}m`, `{{x}}h`, here `s = seconds`, `m = minutes` and `h = hours`. The value `{{x}}` can be anything we wish. Example : `10s` would mean we would like the polling to occur every 10 seconds. If no value is specified for this, by default its initialized to `5 minutes`. This attribute can be specified both at the root level of the configuration as well at the bucket level. The bucket level values will always take priority -and override the root level values if both are specified. The `poll_interval` should be set to a value that is equal to the `bucket_timeout` value. This would ensure that another schedule operation is not started before the current buckets have all been processed. If the `poll_interval` is set to a value that is less than the `bucket_timeout`, then the input will start another schedule operation before the current one has finished, which can cause a bottleneck over time. Having a lower `poll_interval` can make the input faster at the cost of more resource utilization. - -NOTE: Some edge case scenarios could require different values for `poll_interval` and `bucket_timeout`. For example, if the files are very large and the network speed is slow, then the `bucket_timeout` value should be set to a higher value than the `poll_interval`. This would ensure that polling operation does not wait too long for the files to be read and moves to the next iteration while the current one is still being processed. This would ensure a higher throughput and better resource utilization. +and override the root level values if both are specified. Having a lower `poll_interval` can make the input faster at the cost of more resource utilization. [id="attrib-parse_json"] [float] @@ -322,7 +309,6 @@ filebeat.inputs: max_workers: 3 poll: true poll_interval: 15s - bucket_timeout: 60s file_selectors: - regex: '/Monitoring/' - regex: 'docs/' @@ -368,7 +354,6 @@ filebeat.inputs: max_workers: 3 poll: true poll_interval: 15s - bucket_timeout: 60s expand_event_list_from_field: Records ---- @@ -392,7 +377,6 @@ filebeat.inputs: max_workers: 3 poll: true poll_interval: 15s - bucket_timeout: 60s timestamp_epoch: 1630444800 ---- @@ -432,11 +416,8 @@ filebeat.inputs: max_workers: 3 poll: true poll_interval: 11m - bucket_timeout: 10m ---- -When configuring the `retry` attribute, the user should consider the `bucket_timeout` value. The `retry` attribute should be configured in such a way that the retries are completed within the `bucket_timeout` window. If the `retry` attribute is configured in such a way that the retries are not completed successfully within the `bucket_timeout` window, the input will suffer a `context timeout` for that specific object/file which it was retrying. This can cause gaps in ingested data to pile up over time. - [id="bucket-overrides"] *The sample configs below will explain the bucket level overriding of attributes a bit further :-* diff --git a/x-pack/filebeat/input/gcs/config.go b/x-pack/filebeat/input/gcs/config.go index 9a9f6dceadd..3c8f2d02a7c 100644 --- a/x-pack/filebeat/input/gcs/config.go +++ b/x-pack/filebeat/input/gcs/config.go @@ -36,8 +36,6 @@ type config struct { // ParseJSON - Informs the publisher whether to parse & objectify json data or not. By default this is set to // false, since it can get expensive dealing with highly nested json data. ParseJSON bool `config:"parse_json"` - // BucketTimeOut - Defines the maximum time that the sdk will wait for a bucket api response before timing out. - BucketTimeOut time.Duration `config:"bucket_timeout"` // Buckets - Defines a list of buckets that will be polled for objects. Buckets []bucket `config:"buckets" validate:"required"` // FileSelectors - Defines a list of regex patterns that can be used to filter out objects from the bucket. @@ -58,7 +56,6 @@ type config struct { type bucket struct { Name string `config:"name" validate:"required"` MaxWorkers *int `config:"max_workers" validate:"max=5000"` - BucketTimeOut *time.Duration `config:"bucket_timeout"` Poll *bool `config:"poll"` PollInterval *time.Duration `config:"poll_interval"` ParseJSON *bool `config:"parse_json"` @@ -136,11 +133,10 @@ func (c authConfig) Validate() error { // defaultConfig returns the default configuration for the input func defaultConfig() config { return config{ - MaxWorkers: 1, - Poll: true, - PollInterval: 5 * time.Minute, - BucketTimeOut: 120 * time.Second, - ParseJSON: false, + MaxWorkers: 1, + Poll: true, + PollInterval: 5 * time.Minute, + ParseJSON: false, Retry: retryConfig{ MaxAttempts: 3, InitialBackOffDuration: time.Second, diff --git a/x-pack/filebeat/input/gcs/input.go b/x-pack/filebeat/input/gcs/input.go index 1d6bff8b857..77580f70e40 100644 --- a/x-pack/filebeat/input/gcs/input.go +++ b/x-pack/filebeat/input/gcs/input.go @@ -63,7 +63,6 @@ func configure(cfg *conf.C) ([]cursor.Source, cursor.Input, error) { sources = append(sources, &Source{ ProjectId: config.ProjectId, BucketName: bucket.Name, - BucketTimeOut: *bucket.BucketTimeOut, MaxWorkers: *bucket.MaxWorkers, Poll: *bucket.Poll, PollInterval: *bucket.PollInterval, @@ -93,9 +92,6 @@ func tryOverrideOrDefault(cfg config, b bucket) bucket { if b.ParseJSON == nil { b.ParseJSON = &cfg.ParseJSON } - if b.BucketTimeOut == nil { - b.BucketTimeOut = &cfg.BucketTimeOut - } if b.TimeStampEpoch == nil { b.TimeStampEpoch = cfg.TimeStampEpoch } diff --git a/x-pack/filebeat/input/gcs/input_stateless.go b/x-pack/filebeat/input/gcs/input_stateless.go index b6901f0df25..bceb7dffb54 100644 --- a/x-pack/filebeat/input/gcs/input_stateless.go +++ b/x-pack/filebeat/input/gcs/input_stateless.go @@ -54,7 +54,6 @@ func (in *statelessInput) Run(inputCtx v2.Context, publisher stateless.Publisher source = &Source{ ProjectId: in.config.ProjectId, BucketName: bucket.Name, - BucketTimeOut: *bucket.BucketTimeOut, MaxWorkers: *bucket.MaxWorkers, Poll: *bucket.Poll, PollInterval: *bucket.PollInterval, diff --git a/x-pack/filebeat/input/gcs/input_test.go b/x-pack/filebeat/input/gcs/input_test.go index 345c7c57909..8ff0576bdf5 100644 --- a/x-pack/filebeat/input/gcs/input_test.go +++ b/x-pack/filebeat/input/gcs/input_test.go @@ -528,7 +528,6 @@ func Test_StorageClient(t *testing.T) { "max_workers": 1, "poll": true, "poll_interval": "1m", - "bucket_timeout": "1m", "buckets": []map[string]interface{}{ { "name": "gcs-test-new", @@ -550,7 +549,6 @@ func Test_StorageClient(t *testing.T) { "max_workers": 1, "poll": true, "poll_interval": "10s", - "bucket_timeout": "10s", "retry": map[string]interface{}{ "max_attempts": 5, "initial_backoff_duration": "1s", @@ -578,7 +576,6 @@ func Test_StorageClient(t *testing.T) { "max_workers": 1, "poll": true, "poll_interval": "10s", - "bucket_timeout": "10s", "retry": map[string]interface{}{ "max_attempts": 5, "initial_backoff_duration": "1s", diff --git a/x-pack/filebeat/input/gcs/job.go b/x-pack/filebeat/input/gcs/job.go index 11420002159..6de97561b3c 100644 --- a/x-pack/filebeat/input/gcs/job.go +++ b/x-pack/filebeat/input/gcs/job.go @@ -147,10 +147,8 @@ func (j *job) Timestamp() time.Time { } func (j *job) processAndPublishData(ctx context.Context, id string) error { - ctxWithTimeout, cancel := context.WithTimeout(ctx, j.src.BucketTimeOut) - defer cancel() obj := j.bucket.Object(j.object.Name) - reader, err := obj.NewReader(ctxWithTimeout) + reader, err := obj.NewReader(ctx) if err != nil { return fmt.Errorf("failed to open reader for object: %s, with error: %w", j.object.Name, err) } diff --git a/x-pack/filebeat/input/gcs/types.go b/x-pack/filebeat/input/gcs/types.go index 82fb737cdb6..72bf98e08e5 100644 --- a/x-pack/filebeat/input/gcs/types.go +++ b/x-pack/filebeat/input/gcs/types.go @@ -12,7 +12,6 @@ import ( // Source, it is the cursor source type Source struct { BucketName string - BucketTimeOut time.Duration ProjectId string MaxWorkers int Poll bool From fb93eee6c66e000efe90bab628b58ef7687f9b9a Mon Sep 17 00:00:00 2001 From: Anderson Queiroz Date: Wed, 11 Dec 2024 07:34:18 +0100 Subject: [PATCH 8/8] Remove functionbeat (#41506) * Remove functionbeat * Add changelog entry for functionbeat removal --------- Co-authored-by: julienlind --- .buildkite/packaging.pipeline.yml | 4 +- .../workflows/check-xpack-functionbeat.yml | 28 - .../updatecli.d/bump-golang-7.17.yml | 10 - .github/workflows/updatecli.d/bump-golang.yml | 10 - .gitignore | 3 - CHANGELOG.next.asciidoc | 2 + Makefile | 2 +- NOTICE.txt | 986 +- README.md | 2 - dev-tools/cmd/update_go/update_go_version.go | 1 - docs/devguide/documentation.asciidoc | 3 +- go.mod | 9 +- go.sum | 20 +- libbeat/docs/command-reference.asciidoc | 140 +- libbeat/docs/overview.asciidoc | 1 - libbeat/publisher/pipeline/sync_client.go | 106 - .../publisher/pipeline/sync_client_test.go | 132 - x-pack/functionbeat/.gitignore | 10 - x-pack/functionbeat/Dockerfile | 25 - x-pack/functionbeat/Jenkinsfile.yml | 100 - x-pack/functionbeat/Makefile | 10 - .../_meta/config/beat.reference.yml.tmpl | 297 - .../functionbeat/_meta/config/beat.yml.tmpl | 253 - x-pack/functionbeat/_meta/fields.yml | 4 - x-pack/functionbeat/config/config.go | 143 - x-pack/functionbeat/config/config_test.go | 128 - x-pack/functionbeat/conftest.py | 5 - .../dev-tools/packaging/packages.yml | 100 - x-pack/functionbeat/docker-compose.yml | 28 - .../docs/config-options-aws.asciidoc | 219 - .../docs/configuring-howto.asciidoc | 66 - x-pack/functionbeat/docs/deploying.asciidoc | 113 - .../export-cloudformation-template.asciidoc | 27 - .../docs/faq-resource-limit.asciidoc | 55 - x-pack/functionbeat/docs/faq.asciidoc | 23 - x-pack/functionbeat/docs/fields.asciidoc | 15676 ---------------- x-pack/functionbeat/docs/filtering.asciidoc | 30 - .../docs/general-options.asciidoc | 13 - .../docs/getting-started.asciidoc | 167 - x-pack/functionbeat/docs/howto/howto.asciidoc | 42 - .../docs/iam-permissions.asciidoc | 134 - .../docs/images/coordinate-map.png | Bin 370029 -> 0 bytes .../diagram-functionbeat-architecture.svg | 568 - .../functionbeat-pipeline-cloudwatchlogs.png | Bin 82236 -> 0 bytes .../docs/images/functionbeat-pipeline-sqs.png | Bin 81731 -> 0 bytes x-pack/functionbeat/docs/index.asciidoc | 64 - x-pack/functionbeat/docs/overview.asciidoc | 99 - x-pack/functionbeat/docs/page_header.html | 3 - .../docs/setting-up-running.asciidoc | 45 - .../credentials-aws-widget.asciidoc | 58 - .../docs/tab-widgets/credentials-aws.asciidoc | 26 - .../tab-widgets/deploy-aws-widget.asciidoc | 58 - .../docs/tab-widgets/deploy-aws.asciidoc | 19 - .../docs/troubleshooting.asciidoc | 43 - .../function/beater/functionbeat.go | 185 - .../function/beater/proccessors_test.go | 124 - .../function/beater/processors.go | 38 - x-pack/functionbeat/function/cmd/root.go | 54 - .../functionbeat/function/core/coordinator.go | 98 - .../function/core/coordinator_test.go | 58 - x-pack/functionbeat/function/provider/cli.go | 32 - .../function/provider/default_provider.go | 112 - .../functionbeat/function/provider/feature.go | 64 - .../function/provider/feature_test.go | 51 - .../function/provider/provider.go | 133 - .../function/provider/provider_test.go | 74 - .../function/provider/registry.go | 217 - .../function/provider/registry_test.go | 274 - .../function/provider/template.go | 19 - .../function/telemetry/telemetry.go | 37 - .../functionbeat/functionbeat.reference.yml | 1573 -- x-pack/functionbeat/functionbeat.yml | 416 - x-pack/functionbeat/include/feature.go | 16 - x-pack/functionbeat/include/fields.go | 23 - x-pack/functionbeat/magefile.go | 234 - x-pack/functionbeat/main.go | 19 - x-pack/functionbeat/main_test.go | 40 - x-pack/functionbeat/make.bat | 11 - x-pack/functionbeat/manager/aws/aws.go | 33 - .../functionbeat/manager/aws/cli_manager.go | 240 - .../manager/aws/cli_manager_test.go | 38 - .../manager/aws/cloudformation_interface.go | 24 - .../manager/aws/event_stack_poller.go | 157 - .../manager/aws/event_stack_poller_test.go | 341 - .../manager/aws/op_cloudformation.go | 110 - .../manager/aws/op_cloudformation_test.go | 211 - .../manager/aws/op_delete_cloudformation.go | 63 - .../manager/aws/op_delete_file_bucket.go | 52 - .../manager/aws/op_ensure_bucket.go | 61 - .../manager/aws/op_update_cloudformation.go | 68 - .../manager/aws/op_upload_to_bucket.go | 68 - .../manager/aws/op_wait_cloud_formation.go | 145 - .../functionbeat/manager/aws/policies_test.go | 71 - .../functionbeat/manager/aws/stack_context.go | 24 - .../manager/aws/template_builder.go | 331 - .../manager/beater/functionbeat.go | 58 - .../functionbeat/manager/cmd/cli_handler.go | 162 - .../manager/cmd/cli_handler_test.go | 161 - .../functionbeat/manager/cmd/provider_cmd.go | 142 - x-pack/functionbeat/manager/cmd/root.go | 50 - .../manager/core/bundle/bundle.go | 243 - .../manager/core/bundle/bundle_test.go | 150 - .../manager/core/bundle/testdata/lipsum.txt | 1 - x-pack/functionbeat/manager/core/makezip.go | 115 - .../functionbeat/manager/executor/executor.go | 112 - .../manager/executor/executor_test.go | 181 - .../provider/aws/aws/api_gateway_proxy.go | 96 - .../aws/aws/api_gateway_proxy_test.go | 92 - .../provider/aws/aws/cloudwatch_kinesis.go | 117 - .../provider/aws/aws/cloudwatch_logs.go | 230 - .../provider/aws/aws/cloudwatch_logs_test.go | 153 - .../functionbeat/provider/aws/aws/config.go | 186 - .../provider/aws/aws/config_test.go | 135 - .../functionbeat/provider/aws/aws/kinesis.go | 226 - .../provider/aws/aws/kinesis_test.go | 302 - x-pack/functionbeat/provider/aws/aws/sqs.go | 164 - .../functionbeat/provider/aws/aws/sqs_test.go | 67 - .../aws/aws/transformer/transformer.go | 234 - .../aws/aws/transformer/transformer_test.go | 403 - x-pack/functionbeat/provider/aws/cmd/root.go | 29 - .../provider/aws/include/feature.go | 37 - x-pack/functionbeat/provider/aws/main.go | 18 - x-pack/functionbeat/provider/aws/main_test.go | 35 - .../functionbeat/provider/local/cmd/root.go | 20 - .../provider/local/include/feature.go | 14 - .../provider/local/local/local.go | 103 - x-pack/functionbeat/provider/local/main.go | 18 - .../functionbeat/provider/local/main_test.go | 35 - x-pack/functionbeat/scripts/mage/config.go | 23 - x-pack/functionbeat/scripts/mage/providers.go | 55 - x-pack/functionbeat/scripts/mage/update.go | 48 - .../tests/system/config/functionbeat.yml.j2 | 101 - .../functionbeat/tests/system/functionbeat.py | 12 - .../tests/system/requirements.txt | 1 - x-pack/functionbeat/tests/system/test_base.py | 118 - .../docs/aws-credentials-config.asciidoc | 4 - 136 files changed, 76 insertions(+), 30424 deletions(-) delete mode 100644 .github/workflows/check-xpack-functionbeat.yml delete mode 100644 libbeat/publisher/pipeline/sync_client.go delete mode 100644 libbeat/publisher/pipeline/sync_client_test.go delete mode 100644 x-pack/functionbeat/.gitignore delete mode 100644 x-pack/functionbeat/Dockerfile delete mode 100644 x-pack/functionbeat/Jenkinsfile.yml delete mode 100644 x-pack/functionbeat/Makefile delete mode 100644 x-pack/functionbeat/_meta/config/beat.reference.yml.tmpl delete mode 100644 x-pack/functionbeat/_meta/config/beat.yml.tmpl delete mode 100644 x-pack/functionbeat/_meta/fields.yml delete mode 100644 x-pack/functionbeat/config/config.go delete mode 100644 x-pack/functionbeat/config/config_test.go delete mode 100644 x-pack/functionbeat/conftest.py delete mode 100644 x-pack/functionbeat/dev-tools/packaging/packages.yml delete mode 100644 x-pack/functionbeat/docker-compose.yml delete mode 100644 x-pack/functionbeat/docs/config-options-aws.asciidoc delete mode 100644 x-pack/functionbeat/docs/configuring-howto.asciidoc delete mode 100644 x-pack/functionbeat/docs/deploying.asciidoc delete mode 100644 x-pack/functionbeat/docs/export-cloudformation-template.asciidoc delete mode 100644 x-pack/functionbeat/docs/faq-resource-limit.asciidoc delete mode 100644 x-pack/functionbeat/docs/faq.asciidoc delete mode 100644 x-pack/functionbeat/docs/fields.asciidoc delete mode 100644 x-pack/functionbeat/docs/filtering.asciidoc delete mode 100644 x-pack/functionbeat/docs/general-options.asciidoc delete mode 100644 x-pack/functionbeat/docs/getting-started.asciidoc delete mode 100644 x-pack/functionbeat/docs/howto/howto.asciidoc delete mode 100644 x-pack/functionbeat/docs/iam-permissions.asciidoc delete mode 100644 x-pack/functionbeat/docs/images/coordinate-map.png delete mode 100644 x-pack/functionbeat/docs/images/diagram-functionbeat-architecture.svg delete mode 100644 x-pack/functionbeat/docs/images/functionbeat-pipeline-cloudwatchlogs.png delete mode 100644 x-pack/functionbeat/docs/images/functionbeat-pipeline-sqs.png delete mode 100644 x-pack/functionbeat/docs/index.asciidoc delete mode 100644 x-pack/functionbeat/docs/overview.asciidoc delete mode 100644 x-pack/functionbeat/docs/page_header.html delete mode 100644 x-pack/functionbeat/docs/setting-up-running.asciidoc delete mode 100644 x-pack/functionbeat/docs/tab-widgets/credentials-aws-widget.asciidoc delete mode 100644 x-pack/functionbeat/docs/tab-widgets/credentials-aws.asciidoc delete mode 100644 x-pack/functionbeat/docs/tab-widgets/deploy-aws-widget.asciidoc delete mode 100644 x-pack/functionbeat/docs/tab-widgets/deploy-aws.asciidoc delete mode 100644 x-pack/functionbeat/docs/troubleshooting.asciidoc delete mode 100644 x-pack/functionbeat/function/beater/functionbeat.go delete mode 100644 x-pack/functionbeat/function/beater/proccessors_test.go delete mode 100644 x-pack/functionbeat/function/beater/processors.go delete mode 100644 x-pack/functionbeat/function/cmd/root.go delete mode 100644 x-pack/functionbeat/function/core/coordinator.go delete mode 100644 x-pack/functionbeat/function/core/coordinator_test.go delete mode 100644 x-pack/functionbeat/function/provider/cli.go delete mode 100644 x-pack/functionbeat/function/provider/default_provider.go delete mode 100644 x-pack/functionbeat/function/provider/feature.go delete mode 100644 x-pack/functionbeat/function/provider/feature_test.go delete mode 100644 x-pack/functionbeat/function/provider/provider.go delete mode 100644 x-pack/functionbeat/function/provider/provider_test.go delete mode 100644 x-pack/functionbeat/function/provider/registry.go delete mode 100644 x-pack/functionbeat/function/provider/registry_test.go delete mode 100644 x-pack/functionbeat/function/provider/template.go delete mode 100644 x-pack/functionbeat/function/telemetry/telemetry.go delete mode 100644 x-pack/functionbeat/functionbeat.reference.yml delete mode 100644 x-pack/functionbeat/functionbeat.yml delete mode 100644 x-pack/functionbeat/include/feature.go delete mode 100644 x-pack/functionbeat/include/fields.go delete mode 100644 x-pack/functionbeat/magefile.go delete mode 100644 x-pack/functionbeat/main.go delete mode 100644 x-pack/functionbeat/main_test.go delete mode 100644 x-pack/functionbeat/make.bat delete mode 100644 x-pack/functionbeat/manager/aws/aws.go delete mode 100644 x-pack/functionbeat/manager/aws/cli_manager.go delete mode 100644 x-pack/functionbeat/manager/aws/cli_manager_test.go delete mode 100644 x-pack/functionbeat/manager/aws/cloudformation_interface.go delete mode 100644 x-pack/functionbeat/manager/aws/event_stack_poller.go delete mode 100644 x-pack/functionbeat/manager/aws/event_stack_poller_test.go delete mode 100644 x-pack/functionbeat/manager/aws/op_cloudformation.go delete mode 100644 x-pack/functionbeat/manager/aws/op_cloudformation_test.go delete mode 100644 x-pack/functionbeat/manager/aws/op_delete_cloudformation.go delete mode 100644 x-pack/functionbeat/manager/aws/op_delete_file_bucket.go delete mode 100644 x-pack/functionbeat/manager/aws/op_ensure_bucket.go delete mode 100644 x-pack/functionbeat/manager/aws/op_update_cloudformation.go delete mode 100644 x-pack/functionbeat/manager/aws/op_upload_to_bucket.go delete mode 100644 x-pack/functionbeat/manager/aws/op_wait_cloud_formation.go delete mode 100644 x-pack/functionbeat/manager/aws/policies_test.go delete mode 100644 x-pack/functionbeat/manager/aws/stack_context.go delete mode 100644 x-pack/functionbeat/manager/aws/template_builder.go delete mode 100644 x-pack/functionbeat/manager/beater/functionbeat.go delete mode 100644 x-pack/functionbeat/manager/cmd/cli_handler.go delete mode 100644 x-pack/functionbeat/manager/cmd/cli_handler_test.go delete mode 100644 x-pack/functionbeat/manager/cmd/provider_cmd.go delete mode 100644 x-pack/functionbeat/manager/cmd/root.go delete mode 100644 x-pack/functionbeat/manager/core/bundle/bundle.go delete mode 100644 x-pack/functionbeat/manager/core/bundle/bundle_test.go delete mode 100644 x-pack/functionbeat/manager/core/bundle/testdata/lipsum.txt delete mode 100644 x-pack/functionbeat/manager/core/makezip.go delete mode 100644 x-pack/functionbeat/manager/executor/executor.go delete mode 100644 x-pack/functionbeat/manager/executor/executor_test.go delete mode 100644 x-pack/functionbeat/provider/aws/aws/api_gateway_proxy.go delete mode 100644 x-pack/functionbeat/provider/aws/aws/api_gateway_proxy_test.go delete mode 100644 x-pack/functionbeat/provider/aws/aws/cloudwatch_kinesis.go delete mode 100644 x-pack/functionbeat/provider/aws/aws/cloudwatch_logs.go delete mode 100644 x-pack/functionbeat/provider/aws/aws/cloudwatch_logs_test.go delete mode 100644 x-pack/functionbeat/provider/aws/aws/config.go delete mode 100644 x-pack/functionbeat/provider/aws/aws/config_test.go delete mode 100644 x-pack/functionbeat/provider/aws/aws/kinesis.go delete mode 100644 x-pack/functionbeat/provider/aws/aws/kinesis_test.go delete mode 100644 x-pack/functionbeat/provider/aws/aws/sqs.go delete mode 100644 x-pack/functionbeat/provider/aws/aws/sqs_test.go delete mode 100644 x-pack/functionbeat/provider/aws/aws/transformer/transformer.go delete mode 100644 x-pack/functionbeat/provider/aws/aws/transformer/transformer_test.go delete mode 100644 x-pack/functionbeat/provider/aws/cmd/root.go delete mode 100644 x-pack/functionbeat/provider/aws/include/feature.go delete mode 100644 x-pack/functionbeat/provider/aws/main.go delete mode 100644 x-pack/functionbeat/provider/aws/main_test.go delete mode 100644 x-pack/functionbeat/provider/local/cmd/root.go delete mode 100644 x-pack/functionbeat/provider/local/include/feature.go delete mode 100644 x-pack/functionbeat/provider/local/local/local.go delete mode 100644 x-pack/functionbeat/provider/local/main.go delete mode 100644 x-pack/functionbeat/provider/local/main_test.go delete mode 100644 x-pack/functionbeat/scripts/mage/config.go delete mode 100644 x-pack/functionbeat/scripts/mage/providers.go delete mode 100644 x-pack/functionbeat/scripts/mage/update.go delete mode 100644 x-pack/functionbeat/tests/system/config/functionbeat.yml.j2 delete mode 100644 x-pack/functionbeat/tests/system/functionbeat.py delete mode 100644 x-pack/functionbeat/tests/system/requirements.txt delete mode 100644 x-pack/functionbeat/tests/system/test_base.py diff --git a/.buildkite/packaging.pipeline.yml b/.buildkite/packaging.pipeline.yml index ecf2dca5cc0..ec85d9accd4 100644 --- a/.buildkite/packaging.pipeline.yml +++ b/.buildkite/packaging.pipeline.yml @@ -111,7 +111,6 @@ steps: - x-pack/auditbeat - x-pack/dockerlogbeat - x-pack/filebeat - - x-pack/functionbeat - x-pack/heartbeat - x-pack/metricbeat - x-pack/osquerybeat @@ -200,7 +199,6 @@ steps: - x-pack/auditbeat - x-pack/dockerlogbeat - x-pack/filebeat - - x-pack/functionbeat - x-pack/heartbeat - x-pack/metricbeat - x-pack/osquerybeat @@ -269,7 +267,7 @@ steps: - packaging-snapshot - dashboards-snapshot command: | - buildkite-agent artifact download "build/**/*" . + buildkite-agent artifact download "build/**/*" . .buildkite/scripts/packaging/prepare-release-manager.sh snapshot .buildkite/scripts/dra.sh agents: diff --git a/.github/workflows/check-xpack-functionbeat.yml b/.github/workflows/check-xpack-functionbeat.yml deleted file mode 100644 index d51a18ea1a5..00000000000 --- a/.github/workflows/check-xpack-functionbeat.yml +++ /dev/null @@ -1,28 +0,0 @@ -name: check-x-pack-functionbeat - -on: - pull_request: - paths: - - '.github/workflows/check-xpack-functionbeat.yml' - - 'x-pack/functionbeat/**' - - 'functionbeat/**' - -env: - BEAT_MODULE: 'x-pack/functionbeat' - -permissions: - contents: read - -jobs: - check: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v4 - - uses: actions/setup-go@v5 - with: - go-version-file: .go-version - - name: Run check/update - run: | - go install github.com/magefile/mage - make -C ${{ env.BEAT_MODULE }} check update - make check-no-changes diff --git a/.github/workflows/updatecli.d/bump-golang-7.17.yml b/.github/workflows/updatecli.d/bump-golang-7.17.yml index 34a60b31c4d..8c1ba9b4205 100644 --- a/.github/workflows/updatecli.d/bump-golang-7.17.yml +++ b/.github/workflows/updatecli.d/bump-golang-7.17.yml @@ -157,16 +157,6 @@ targets: keyword: "FROM" matcher: "golang" file: ./packetbeat/Dockerfile - update-functionbeat-dockerfile: - name: "Update Functionbeat Dockerfile" - sourceid: latestGoVersion - scmid: githubConfig - kind: dockerfile - spec: - instruction: - keyword: "FROM" - matcher: "golang" - file: ./x-pack/functionbeat/Dockerfile update-nats-module-dockerfile: name: "Update NATS module Dockerfile" sourceid: latestGoVersion diff --git a/.github/workflows/updatecli.d/bump-golang.yml b/.github/workflows/updatecli.d/bump-golang.yml index f03c5471e63..70c831b68ba 100644 --- a/.github/workflows/updatecli.d/bump-golang.yml +++ b/.github/workflows/updatecli.d/bump-golang.yml @@ -166,16 +166,6 @@ targets: keyword: "FROM" matcher: "golang" file: ./packetbeat/Dockerfile - update-functionbeat-dockerfile: - name: "Update Functionbeat Dockerfile" - sourceid: latestGoVersion - scmid: githubConfig - kind: dockerfile - spec: - instruction: - keyword: "FROM" - matcher: "golang" - file: ./x-pack/functionbeat/Dockerfile update-nats-module-dockerfile: name: "Update NATS module Dockerfile" sourceid: latestGoVersion diff --git a/.gitignore b/.gitignore index 70941e28149..b3c2bdc0d98 100644 --- a/.gitignore +++ b/.gitignore @@ -11,7 +11,6 @@ *beat/logs *beat/data **/ironbank/build/ -x-pack/functionbeat/pkg # Files .DS_Store @@ -24,8 +23,6 @@ beat.db *.keystore go_env.properties mage_output_file.go -x-pack/functionbeat/*/fields.yml -x-pack/functionbeat/provider/*/functionbeat-* x-pack/dockerlogbeat/temproot.tar # Editor swap files diff --git a/CHANGELOG.next.asciidoc b/CHANGELOG.next.asciidoc index 9c0fbc06447..79eb7b66e59 100644 --- a/CHANGELOG.next.asciidoc +++ b/CHANGELOG.next.asciidoc @@ -440,6 +440,8 @@ https://github.com/elastic/beats/compare/v8.8.1\...main[Check the HEAD diff] *Functionbeat* +- Removal of functionbeat binaries from CI pipelines {issue}40745[40745] {pull}41506[41506] + *Elastic Log Driver* *Elastic Logging Plugin* diff --git a/Makefile b/Makefile index b9be661dc25..2980974dc04 100644 --- a/Makefile +++ b/Makefile @@ -1,6 +1,6 @@ BUILD_DIR=$(CURDIR)/build COVERAGE_DIR=$(BUILD_DIR)/coverage -BEATS?=auditbeat filebeat heartbeat metricbeat packetbeat winlogbeat x-pack/agentbeat x-pack/auditbeat x-pack/dockerlogbeat x-pack/filebeat x-pack/functionbeat x-pack/heartbeat x-pack/metricbeat x-pack/osquerybeat x-pack/packetbeat x-pack/winlogbeat +BEATS?=auditbeat filebeat heartbeat metricbeat packetbeat winlogbeat x-pack/agentbeat x-pack/auditbeat x-pack/dockerlogbeat x-pack/filebeat x-pack/heartbeat x-pack/metricbeat x-pack/osquerybeat x-pack/packetbeat x-pack/winlogbeat PROJECTS=libbeat x-pack/libbeat $(BEATS) PROJECTS_ENV=libbeat filebeat metricbeat PYTHON_ENV?=$(BUILD_DIR)/python-env diff --git a/NOTICE.txt b/NOTICE.txt index 4f9b5ad5e7f..dd599cb5cb1 100644 --- a/NOTICE.txt +++ b/NOTICE.txt @@ -1711,11 +1711,11 @@ Contents of probable licence file $GOMODCACHE/github.com/!azure/azure-event-hubs -------------------------------------------------------------------------------- Dependency : github.com/Azure/azure-sdk-for-go -Version: v65.0.0+incompatible +Version: v68.0.0+incompatible Licence type (autodetected): MIT -------------------------------------------------------------------------------- -Contents of probable licence file $GOMODCACHE/github.com/!azure/azure-sdk-for-go@v65.0.0+incompatible/LICENSE.txt: +Contents of probable licence file $GOMODCACHE/github.com/!azure/azure-sdk-for-go@v68.0.0+incompatible/LICENSE.txt: The MIT License (MIT) @@ -4819,12 +4819,12 @@ CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. -------------------------------------------------------------------------------- -Dependency : github.com/aws/aws-lambda-go -Version: v1.44.0 +Dependency : github.com/aws/aws-sdk-go-v2 +Version: v1.30.5 Licence type (autodetected): Apache-2.0 -------------------------------------------------------------------------------- -Contents of probable licence file $GOMODCACHE/github.com/aws/aws-lambda-go@v1.44.0/LICENSE: +Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2@v1.30.5/LICENSE.txt: Apache License @@ -5030,14 +5030,13 @@ Contents of probable licence file $GOMODCACHE/github.com/aws/aws-lambda-go@v1.44 limitations under the License. - -------------------------------------------------------------------------------- -Dependency : github.com/aws/aws-sdk-go-v2 -Version: v1.30.5 +Dependency : github.com/aws/aws-sdk-go-v2/config +Version: v1.27.29 Licence type (autodetected): Apache-2.0 -------------------------------------------------------------------------------- -Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2@v1.30.5/LICENSE.txt: +Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/config@v1.27.29/LICENSE.txt: Apache License @@ -5244,12 +5243,12 @@ Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2@v1.30 -------------------------------------------------------------------------------- -Dependency : github.com/aws/aws-sdk-go-v2/config -Version: v1.27.29 +Dependency : github.com/aws/aws-sdk-go-v2/credentials +Version: v1.17.29 Licence type (autodetected): Apache-2.0 -------------------------------------------------------------------------------- -Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/config@v1.27.29/LICENSE.txt: +Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/credentials@v1.17.29/LICENSE.txt: Apache License @@ -5456,12 +5455,12 @@ Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/confi -------------------------------------------------------------------------------- -Dependency : github.com/aws/aws-sdk-go-v2/credentials -Version: v1.17.29 +Dependency : github.com/aws/aws-sdk-go-v2/feature/ec2/imds +Version: v1.16.12 Licence type (autodetected): Apache-2.0 -------------------------------------------------------------------------------- -Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/credentials@v1.17.29/LICENSE.txt: +Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/feature/ec2/imds@v1.16.12/LICENSE.txt: Apache License @@ -5668,12 +5667,12 @@ Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/crede -------------------------------------------------------------------------------- -Dependency : github.com/aws/aws-sdk-go-v2/feature/ec2/imds -Version: v1.16.12 +Dependency : github.com/aws/aws-sdk-go-v2/feature/s3/manager +Version: v1.17.13 Licence type (autodetected): Apache-2.0 -------------------------------------------------------------------------------- -Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/feature/ec2/imds@v1.16.12/LICENSE.txt: +Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/feature/s3/manager@v1.17.13/LICENSE.txt: Apache License @@ -5880,12 +5879,12 @@ Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/featu -------------------------------------------------------------------------------- -Dependency : github.com/aws/aws-sdk-go-v2/feature/s3/manager -Version: v1.17.13 +Dependency : github.com/aws/aws-sdk-go-v2/service/apigateway +Version: v1.25.8 Licence type (autodetected): Apache-2.0 -------------------------------------------------------------------------------- -Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/feature/s3/manager@v1.17.13/LICENSE.txt: +Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/service/apigateway@v1.25.8/LICENSE.txt: Apache License @@ -6092,12 +6091,12 @@ Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/featu -------------------------------------------------------------------------------- -Dependency : github.com/aws/aws-sdk-go-v2/service/apigateway -Version: v1.25.8 +Dependency : github.com/aws/aws-sdk-go-v2/service/apigatewayv2 +Version: v1.22.8 Licence type (autodetected): Apache-2.0 -------------------------------------------------------------------------------- -Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/service/apigateway@v1.25.8/LICENSE.txt: +Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/service/apigatewayv2@v1.22.8/LICENSE.txt: Apache License @@ -6304,12 +6303,12 @@ Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/servi -------------------------------------------------------------------------------- -Dependency : github.com/aws/aws-sdk-go-v2/service/apigatewayv2 -Version: v1.22.8 +Dependency : github.com/aws/aws-sdk-go-v2/service/cloudwatch +Version: v1.40.5 Licence type (autodetected): Apache-2.0 -------------------------------------------------------------------------------- -Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/service/apigatewayv2@v1.22.8/LICENSE.txt: +Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/service/cloudwatch@v1.40.5/LICENSE.txt: Apache License @@ -6516,12 +6515,12 @@ Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/servi -------------------------------------------------------------------------------- -Dependency : github.com/aws/aws-sdk-go-v2/service/cloudformation -Version: v1.53.5 +Dependency : github.com/aws/aws-sdk-go-v2/service/cloudwatchlogs +Version: v1.37.5 Licence type (autodetected): Apache-2.0 -------------------------------------------------------------------------------- -Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/service/cloudformation@v1.53.5/LICENSE.txt: +Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/service/cloudwatchlogs@v1.37.5/LICENSE.txt: Apache License @@ -6728,12 +6727,12 @@ Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/servi -------------------------------------------------------------------------------- -Dependency : github.com/aws/aws-sdk-go-v2/service/cloudwatch -Version: v1.40.5 +Dependency : github.com/aws/aws-sdk-go-v2/service/costexplorer +Version: v1.40.4 Licence type (autodetected): Apache-2.0 -------------------------------------------------------------------------------- -Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/service/cloudwatch@v1.40.5/LICENSE.txt: +Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/service/costexplorer@v1.40.4/LICENSE.txt: Apache License @@ -6940,12 +6939,12 @@ Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/servi -------------------------------------------------------------------------------- -Dependency : github.com/aws/aws-sdk-go-v2/service/cloudwatchlogs -Version: v1.37.5 +Dependency : github.com/aws/aws-sdk-go-v2/service/ec2 +Version: v1.176.0 Licence type (autodetected): Apache-2.0 -------------------------------------------------------------------------------- -Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/service/cloudwatchlogs@v1.37.5/LICENSE.txt: +Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/service/ec2@v1.176.0/LICENSE.txt: Apache License @@ -7152,12 +7151,12 @@ Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/servi -------------------------------------------------------------------------------- -Dependency : github.com/aws/aws-sdk-go-v2/service/costexplorer -Version: v1.40.4 +Dependency : github.com/aws/aws-sdk-go-v2/service/elasticloadbalancingv2 +Version: v1.34.2 Licence type (autodetected): Apache-2.0 -------------------------------------------------------------------------------- -Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/service/costexplorer@v1.40.4/LICENSE.txt: +Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/service/elasticloadbalancingv2@v1.34.2/LICENSE.txt: Apache License @@ -7364,12 +7363,12 @@ Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/servi -------------------------------------------------------------------------------- -Dependency : github.com/aws/aws-sdk-go-v2/service/ec2 -Version: v1.176.0 +Dependency : github.com/aws/aws-sdk-go-v2/service/health +Version: v1.26.4 Licence type (autodetected): Apache-2.0 -------------------------------------------------------------------------------- -Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/service/ec2@v1.176.0/LICENSE.txt: +Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/service/health@v1.26.4/LICENSE.txt: Apache License @@ -7576,12 +7575,12 @@ Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/servi -------------------------------------------------------------------------------- -Dependency : github.com/aws/aws-sdk-go-v2/service/elasticloadbalancingv2 -Version: v1.34.2 +Dependency : github.com/aws/aws-sdk-go-v2/service/iam +Version: v1.35.0 Licence type (autodetected): Apache-2.0 -------------------------------------------------------------------------------- -Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/service/elasticloadbalancingv2@v1.34.2/LICENSE.txt: +Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/service/iam@v1.35.0/LICENSE.txt: Apache License @@ -7788,12 +7787,12 @@ Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/servi -------------------------------------------------------------------------------- -Dependency : github.com/aws/aws-sdk-go-v2/service/health -Version: v1.26.4 +Dependency : github.com/aws/aws-sdk-go-v2/service/organizations +Version: v1.30.3 Licence type (autodetected): Apache-2.0 -------------------------------------------------------------------------------- -Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/service/health@v1.26.4/LICENSE.txt: +Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/service/organizations@v1.30.3/LICENSE.txt: Apache License @@ -8000,12 +7999,12 @@ Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/servi -------------------------------------------------------------------------------- -Dependency : github.com/aws/aws-sdk-go-v2/service/iam -Version: v1.35.0 +Dependency : github.com/aws/aws-sdk-go-v2/service/rds +Version: v1.82.2 Licence type (autodetected): Apache-2.0 -------------------------------------------------------------------------------- -Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/service/iam@v1.35.0/LICENSE.txt: +Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/service/rds@v1.82.2/LICENSE.txt: Apache License @@ -8212,12 +8211,12 @@ Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/servi -------------------------------------------------------------------------------- -Dependency : github.com/aws/aws-sdk-go-v2/service/kinesis -Version: v1.29.5 +Dependency : github.com/aws/aws-sdk-go-v2/service/resourcegroupstaggingapi +Version: v1.23.5 Licence type (autodetected): Apache-2.0 -------------------------------------------------------------------------------- -Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/service/kinesis@v1.29.5/LICENSE.txt: +Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/service/resourcegroupstaggingapi@v1.23.5/LICENSE.txt: Apache License @@ -8424,12 +8423,12 @@ Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/servi -------------------------------------------------------------------------------- -Dependency : github.com/aws/aws-sdk-go-v2/service/organizations -Version: v1.30.3 +Dependency : github.com/aws/aws-sdk-go-v2/service/s3 +Version: v1.60.1 Licence type (autodetected): Apache-2.0 -------------------------------------------------------------------------------- -Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/service/organizations@v1.30.3/LICENSE.txt: +Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/service/s3@v1.60.1/LICENSE.txt: Apache License @@ -8636,12 +8635,12 @@ Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/servi -------------------------------------------------------------------------------- -Dependency : github.com/aws/aws-sdk-go-v2/service/rds -Version: v1.82.2 +Dependency : github.com/aws/aws-sdk-go-v2/service/sqs +Version: v1.34.5 Licence type (autodetected): Apache-2.0 -------------------------------------------------------------------------------- -Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/service/rds@v1.82.2/LICENSE.txt: +Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/service/sqs@v1.34.5/LICENSE.txt: Apache License @@ -8848,12 +8847,12 @@ Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/servi -------------------------------------------------------------------------------- -Dependency : github.com/aws/aws-sdk-go-v2/service/resourcegroupstaggingapi -Version: v1.23.5 +Dependency : github.com/aws/aws-sdk-go-v2/service/sts +Version: v1.30.5 Licence type (autodetected): Apache-2.0 -------------------------------------------------------------------------------- -Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/service/resourcegroupstaggingapi@v1.23.5/LICENSE.txt: +Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/service/sts@v1.30.5/LICENSE.txt: Apache License @@ -9060,12 +9059,12 @@ Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/servi -------------------------------------------------------------------------------- -Dependency : github.com/aws/aws-sdk-go-v2/service/s3 -Version: v1.60.1 +Dependency : github.com/aws/smithy-go +Version: v1.20.4 Licence type (autodetected): Apache-2.0 -------------------------------------------------------------------------------- -Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/service/s3@v1.60.1/LICENSE.txt: +Contents of probable licence file $GOMODCACHE/github.com/aws/smithy-go@v1.20.4/LICENSE: Apache License @@ -9243,861 +9242,6 @@ Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/servi incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability. - END OF TERMS AND CONDITIONS - - APPENDIX: How to apply the Apache License to your work. - - To apply the Apache License to your work, attach the following - boilerplate notice, with the fields enclosed by brackets "[]" - replaced with your own identifying information. (Don't include - the brackets!) The text should be enclosed in the appropriate - comment syntax for the file format. We also recommend that a - file or class name and description of purpose be included on the - same "printed page" as the copyright notice for easier - identification within third-party archives. - - Copyright [yyyy] [name of copyright owner] - - 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 - - http://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. - - --------------------------------------------------------------------------------- -Dependency : github.com/aws/aws-sdk-go-v2/service/sqs -Version: v1.34.5 -Licence type (autodetected): Apache-2.0 --------------------------------------------------------------------------------- - -Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/service/sqs@v1.34.5/LICENSE.txt: - - - Apache License - Version 2.0, January 2004 - http://www.apache.org/licenses/ - - TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION - - 1. Definitions. - - "License" shall mean the terms and conditions for use, reproduction, - and distribution as defined by Sections 1 through 9 of this document. - - "Licensor" shall mean the copyright owner or entity authorized by - the copyright owner that is granting the License. - - "Legal Entity" shall mean the union of the acting entity and all - other entities that control, are controlled by, or are under common - control with that entity. For the purposes of this definition, - "control" means (i) the power, direct or indirect, to cause the - direction or management of such entity, whether by contract or - otherwise, or (ii) ownership of fifty percent (50%) or more of the - outstanding shares, or (iii) beneficial ownership of such entity. - - "You" (or "Your") shall mean an individual or Legal Entity - exercising permissions granted by this License. - - "Source" form shall mean the preferred form for making modifications, - including but not limited to software source code, documentation - source, and configuration files. - - "Object" form shall mean any form resulting from mechanical - transformation or translation of a Source form, including but - not limited to compiled object code, generated documentation, - and conversions to other media types. - - "Work" shall mean the work of authorship, whether in Source or - Object form, made available under the License, as indicated by a - copyright notice that is included in or attached to the work - (an example is provided in the Appendix below). - - "Derivative Works" shall mean any work, whether in Source or Object - form, that is based on (or derived from) the Work and for which the - editorial revisions, annotations, elaborations, or other modifications - represent, as a whole, an original work of authorship. For the purposes - of this License, Derivative Works shall not include works that remain - separable from, or merely link (or bind by name) to the interfaces of, - the Work and Derivative Works thereof. - - "Contribution" shall mean any work of authorship, including - the original version of the Work and any modifications or additions - to that Work or Derivative Works thereof, that is intentionally - submitted to Licensor for inclusion in the Work by the copyright owner - or by an individual or Legal Entity authorized to submit on behalf of - the copyright owner. For the purposes of this definition, "submitted" - means any form of electronic, verbal, or written communication sent - to the Licensor or its representatives, including but not limited to - communication on electronic mailing lists, source code control systems, - and issue tracking systems that are managed by, or on behalf of, the - Licensor for the purpose of discussing and improving the Work, but - excluding communication that is conspicuously marked or otherwise - designated in writing by the copyright owner as "Not a Contribution." - - "Contributor" shall mean Licensor and any individual or Legal Entity - on behalf of whom a Contribution has been received by Licensor and - subsequently incorporated within the Work. - - 2. Grant of Copyright License. Subject to the terms and conditions of - this License, each Contributor hereby grants to You a perpetual, - worldwide, non-exclusive, no-charge, royalty-free, irrevocable - copyright license to reproduce, prepare Derivative Works of, - publicly display, publicly perform, sublicense, and distribute the - Work and such Derivative Works in Source or Object form. - - 3. Grant of Patent License. Subject to the terms and conditions of - this License, each Contributor hereby grants to You a perpetual, - worldwide, non-exclusive, no-charge, royalty-free, irrevocable - (except as stated in this section) patent license to make, have made, - use, offer to sell, sell, import, and otherwise transfer the Work, - where such license applies only to those patent claims licensable - by such Contributor that are necessarily infringed by their - Contribution(s) alone or by combination of their Contribution(s) - with the Work to which such Contribution(s) was submitted. If You - institute patent litigation against any entity (including a - cross-claim or counterclaim in a lawsuit) alleging that the Work - or a Contribution incorporated within the Work constitutes direct - or contributory patent infringement, then any patent licenses - granted to You under this License for that Work shall terminate - as of the date such litigation is filed. - - 4. Redistribution. You may reproduce and distribute copies of the - Work or Derivative Works thereof in any medium, with or without - modifications, and in Source or Object form, provided that You - meet the following conditions: - - (a) You must give any other recipients of the Work or - Derivative Works a copy of this License; and - - (b) You must cause any modified files to carry prominent notices - stating that You changed the files; and - - (c) You must retain, in the Source form of any Derivative Works - that You distribute, all copyright, patent, trademark, and - attribution notices from the Source form of the Work, - excluding those notices that do not pertain to any part of - the Derivative Works; and - - (d) If the Work includes a "NOTICE" text file as part of its - distribution, then any Derivative Works that You distribute must - include a readable copy of the attribution notices contained - within such NOTICE file, excluding those notices that do not - pertain to any part of the Derivative Works, in at least one - of the following places: within a NOTICE text file distributed - as part of the Derivative Works; within the Source form or - documentation, if provided along with the Derivative Works; or, - within a display generated by the Derivative Works, if and - wherever such third-party notices normally appear. The contents - of the NOTICE file are for informational purposes only and - do not modify the License. You may add Your own attribution - notices within Derivative Works that You distribute, alongside - or as an addendum to the NOTICE text from the Work, provided - that such additional attribution notices cannot be construed - as modifying the License. - - You may add Your own copyright statement to Your modifications and - may provide additional or different license terms and conditions - for use, reproduction, or distribution of Your modifications, or - for any such Derivative Works as a whole, provided Your use, - reproduction, and distribution of the Work otherwise complies with - the conditions stated in this License. - - 5. Submission of Contributions. Unless You explicitly state otherwise, - any Contribution intentionally submitted for inclusion in the Work - by You to the Licensor shall be under the terms and conditions of - this License, without any additional terms or conditions. - Notwithstanding the above, nothing herein shall supersede or modify - the terms of any separate license agreement you may have executed - with Licensor regarding such Contributions. - - 6. Trademarks. This License does not grant permission to use the trade - names, trademarks, service marks, or product names of the Licensor, - except as required for reasonable and customary use in describing the - origin of the Work and reproducing the content of the NOTICE file. - - 7. Disclaimer of Warranty. Unless required by applicable law or - agreed to in writing, Licensor provides the Work (and each - Contributor provides its Contributions) on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or - implied, including, without limitation, any warranties or conditions - of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A - PARTICULAR PURPOSE. You are solely responsible for determining the - appropriateness of using or redistributing the Work and assume any - risks associated with Your exercise of permissions under this License. - - 8. Limitation of Liability. In no event and under no legal theory, - whether in tort (including negligence), contract, or otherwise, - unless required by applicable law (such as deliberate and grossly - negligent acts) or agreed to in writing, shall any Contributor be - liable to You for damages, including any direct, indirect, special, - incidental, or consequential damages of any character arising as a - result of this License or out of the use or inability to use the - Work (including but not limited to damages for loss of goodwill, - work stoppage, computer failure or malfunction, or any and all - other commercial damages or losses), even if such Contributor - has been advised of the possibility of such damages. - - 9. Accepting Warranty or Additional Liability. While redistributing - the Work or Derivative Works thereof, You may choose to offer, - and charge a fee for, acceptance of support, warranty, indemnity, - or other liability obligations and/or rights consistent with this - License. However, in accepting such obligations, You may act only - on Your own behalf and on Your sole responsibility, not on behalf - of any other Contributor, and only if You agree to indemnify, - defend, and hold each Contributor harmless for any liability - incurred by, or claims asserted against, such Contributor by reason - of your accepting any such warranty or additional liability. - - END OF TERMS AND CONDITIONS - - APPENDIX: How to apply the Apache License to your work. - - To apply the Apache License to your work, attach the following - boilerplate notice, with the fields enclosed by brackets "[]" - replaced with your own identifying information. (Don't include - the brackets!) The text should be enclosed in the appropriate - comment syntax for the file format. We also recommend that a - file or class name and description of purpose be included on the - same "printed page" as the copyright notice for easier - identification within third-party archives. - - Copyright [yyyy] [name of copyright owner] - - 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 - - http://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. - - --------------------------------------------------------------------------------- -Dependency : github.com/aws/aws-sdk-go-v2/service/sts -Version: v1.30.5 -Licence type (autodetected): Apache-2.0 --------------------------------------------------------------------------------- - -Contents of probable licence file $GOMODCACHE/github.com/aws/aws-sdk-go-v2/service/sts@v1.30.5/LICENSE.txt: - - - Apache License - Version 2.0, January 2004 - http://www.apache.org/licenses/ - - TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION - - 1. Definitions. - - "License" shall mean the terms and conditions for use, reproduction, - and distribution as defined by Sections 1 through 9 of this document. - - "Licensor" shall mean the copyright owner or entity authorized by - the copyright owner that is granting the License. - - "Legal Entity" shall mean the union of the acting entity and all - other entities that control, are controlled by, or are under common - control with that entity. For the purposes of this definition, - "control" means (i) the power, direct or indirect, to cause the - direction or management of such entity, whether by contract or - otherwise, or (ii) ownership of fifty percent (50%) or more of the - outstanding shares, or (iii) beneficial ownership of such entity. - - "You" (or "Your") shall mean an individual or Legal Entity - exercising permissions granted by this License. - - "Source" form shall mean the preferred form for making modifications, - including but not limited to software source code, documentation - source, and configuration files. - - "Object" form shall mean any form resulting from mechanical - transformation or translation of a Source form, including but - not limited to compiled object code, generated documentation, - and conversions to other media types. - - "Work" shall mean the work of authorship, whether in Source or - Object form, made available under the License, as indicated by a - copyright notice that is included in or attached to the work - (an example is provided in the Appendix below). - - "Derivative Works" shall mean any work, whether in Source or Object - form, that is based on (or derived from) the Work and for which the - editorial revisions, annotations, elaborations, or other modifications - represent, as a whole, an original work of authorship. For the purposes - of this License, Derivative Works shall not include works that remain - separable from, or merely link (or bind by name) to the interfaces of, - the Work and Derivative Works thereof. - - "Contribution" shall mean any work of authorship, including - the original version of the Work and any modifications or additions - to that Work or Derivative Works thereof, that is intentionally - submitted to Licensor for inclusion in the Work by the copyright owner - or by an individual or Legal Entity authorized to submit on behalf of - the copyright owner. For the purposes of this definition, "submitted" - means any form of electronic, verbal, or written communication sent - to the Licensor or its representatives, including but not limited to - communication on electronic mailing lists, source code control systems, - and issue tracking systems that are managed by, or on behalf of, the - Licensor for the purpose of discussing and improving the Work, but - excluding communication that is conspicuously marked or otherwise - designated in writing by the copyright owner as "Not a Contribution." - - "Contributor" shall mean Licensor and any individual or Legal Entity - on behalf of whom a Contribution has been received by Licensor and - subsequently incorporated within the Work. - - 2. Grant of Copyright License. Subject to the terms and conditions of - this License, each Contributor hereby grants to You a perpetual, - worldwide, non-exclusive, no-charge, royalty-free, irrevocable - copyright license to reproduce, prepare Derivative Works of, - publicly display, publicly perform, sublicense, and distribute the - Work and such Derivative Works in Source or Object form. - - 3. Grant of Patent License. Subject to the terms and conditions of - this License, each Contributor hereby grants to You a perpetual, - worldwide, non-exclusive, no-charge, royalty-free, irrevocable - (except as stated in this section) patent license to make, have made, - use, offer to sell, sell, import, and otherwise transfer the Work, - where such license applies only to those patent claims licensable - by such Contributor that are necessarily infringed by their - Contribution(s) alone or by combination of their Contribution(s) - with the Work to which such Contribution(s) was submitted. If You - institute patent litigation against any entity (including a - cross-claim or counterclaim in a lawsuit) alleging that the Work - or a Contribution incorporated within the Work constitutes direct - or contributory patent infringement, then any patent licenses - granted to You under this License for that Work shall terminate - as of the date such litigation is filed. - - 4. Redistribution. You may reproduce and distribute copies of the - Work or Derivative Works thereof in any medium, with or without - modifications, and in Source or Object form, provided that You - meet the following conditions: - - (a) You must give any other recipients of the Work or - Derivative Works a copy of this License; and - - (b) You must cause any modified files to carry prominent notices - stating that You changed the files; and - - (c) You must retain, in the Source form of any Derivative Works - that You distribute, all copyright, patent, trademark, and - attribution notices from the Source form of the Work, - excluding those notices that do not pertain to any part of - the Derivative Works; and - - (d) If the Work includes a "NOTICE" text file as part of its - distribution, then any Derivative Works that You distribute must - include a readable copy of the attribution notices contained - within such NOTICE file, excluding those notices that do not - pertain to any part of the Derivative Works, in at least one - of the following places: within a NOTICE text file distributed - as part of the Derivative Works; within the Source form or - documentation, if provided along with the Derivative Works; or, - within a display generated by the Derivative Works, if and - wherever such third-party notices normally appear. The contents - of the NOTICE file are for informational purposes only and - do not modify the License. You may add Your own attribution - notices within Derivative Works that You distribute, alongside - or as an addendum to the NOTICE text from the Work, provided - that such additional attribution notices cannot be construed - as modifying the License. - - You may add Your own copyright statement to Your modifications and - may provide additional or different license terms and conditions - for use, reproduction, or distribution of Your modifications, or - for any such Derivative Works as a whole, provided Your use, - reproduction, and distribution of the Work otherwise complies with - the conditions stated in this License. - - 5. Submission of Contributions. Unless You explicitly state otherwise, - any Contribution intentionally submitted for inclusion in the Work - by You to the Licensor shall be under the terms and conditions of - this License, without any additional terms or conditions. - Notwithstanding the above, nothing herein shall supersede or modify - the terms of any separate license agreement you may have executed - with Licensor regarding such Contributions. - - 6. Trademarks. This License does not grant permission to use the trade - names, trademarks, service marks, or product names of the Licensor, - except as required for reasonable and customary use in describing the - origin of the Work and reproducing the content of the NOTICE file. - - 7. Disclaimer of Warranty. Unless required by applicable law or - agreed to in writing, Licensor provides the Work (and each - Contributor provides its Contributions) on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or - implied, including, without limitation, any warranties or conditions - of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A - PARTICULAR PURPOSE. You are solely responsible for determining the - appropriateness of using or redistributing the Work and assume any - risks associated with Your exercise of permissions under this License. - - 8. Limitation of Liability. In no event and under no legal theory, - whether in tort (including negligence), contract, or otherwise, - unless required by applicable law (such as deliberate and grossly - negligent acts) or agreed to in writing, shall any Contributor be - liable to You for damages, including any direct, indirect, special, - incidental, or consequential damages of any character arising as a - result of this License or out of the use or inability to use the - Work (including but not limited to damages for loss of goodwill, - work stoppage, computer failure or malfunction, or any and all - other commercial damages or losses), even if such Contributor - has been advised of the possibility of such damages. - - 9. Accepting Warranty or Additional Liability. While redistributing - the Work or Derivative Works thereof, You may choose to offer, - and charge a fee for, acceptance of support, warranty, indemnity, - or other liability obligations and/or rights consistent with this - License. However, in accepting such obligations, You may act only - on Your own behalf and on Your sole responsibility, not on behalf - of any other Contributor, and only if You agree to indemnify, - defend, and hold each Contributor harmless for any liability - incurred by, or claims asserted against, such Contributor by reason - of your accepting any such warranty or additional liability. - - END OF TERMS AND CONDITIONS - - APPENDIX: How to apply the Apache License to your work. - - To apply the Apache License to your work, attach the following - boilerplate notice, with the fields enclosed by brackets "[]" - replaced with your own identifying information. (Don't include - the brackets!) The text should be enclosed in the appropriate - comment syntax for the file format. We also recommend that a - file or class name and description of purpose be included on the - same "printed page" as the copyright notice for easier - identification within third-party archives. - - Copyright [yyyy] [name of copyright owner] - - 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 - - http://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. - - --------------------------------------------------------------------------------- -Dependency : github.com/aws/smithy-go -Version: v1.20.4 -Licence type (autodetected): Apache-2.0 --------------------------------------------------------------------------------- - -Contents of probable licence file $GOMODCACHE/github.com/aws/smithy-go@v1.20.4/LICENSE: - - - Apache License - Version 2.0, January 2004 - http://www.apache.org/licenses/ - - TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION - - 1. Definitions. - - "License" shall mean the terms and conditions for use, reproduction, - and distribution as defined by Sections 1 through 9 of this document. - - "Licensor" shall mean the copyright owner or entity authorized by - the copyright owner that is granting the License. - - "Legal Entity" shall mean the union of the acting entity and all - other entities that control, are controlled by, or are under common - control with that entity. For the purposes of this definition, - "control" means (i) the power, direct or indirect, to cause the - direction or management of such entity, whether by contract or - otherwise, or (ii) ownership of fifty percent (50%) or more of the - outstanding shares, or (iii) beneficial ownership of such entity. - - "You" (or "Your") shall mean an individual or Legal Entity - exercising permissions granted by this License. - - "Source" form shall mean the preferred form for making modifications, - including but not limited to software source code, documentation - source, and configuration files. - - "Object" form shall mean any form resulting from mechanical - transformation or translation of a Source form, including but - not limited to compiled object code, generated documentation, - and conversions to other media types. - - "Work" shall mean the work of authorship, whether in Source or - Object form, made available under the License, as indicated by a - copyright notice that is included in or attached to the work - (an example is provided in the Appendix below). - - "Derivative Works" shall mean any work, whether in Source or Object - form, that is based on (or derived from) the Work and for which the - editorial revisions, annotations, elaborations, or other modifications - represent, as a whole, an original work of authorship. For the purposes - of this License, Derivative Works shall not include works that remain - separable from, or merely link (or bind by name) to the interfaces of, - the Work and Derivative Works thereof. - - "Contribution" shall mean any work of authorship, including - the original version of the Work and any modifications or additions - to that Work or Derivative Works thereof, that is intentionally - submitted to Licensor for inclusion in the Work by the copyright owner - or by an individual or Legal Entity authorized to submit on behalf of - the copyright owner. For the purposes of this definition, "submitted" - means any form of electronic, verbal, or written communication sent - to the Licensor or its representatives, including but not limited to - communication on electronic mailing lists, source code control systems, - and issue tracking systems that are managed by, or on behalf of, the - Licensor for the purpose of discussing and improving the Work, but - excluding communication that is conspicuously marked or otherwise - designated in writing by the copyright owner as "Not a Contribution." - - "Contributor" shall mean Licensor and any individual or Legal Entity - on behalf of whom a Contribution has been received by Licensor and - subsequently incorporated within the Work. - - 2. Grant of Copyright License. Subject to the terms and conditions of - this License, each Contributor hereby grants to You a perpetual, - worldwide, non-exclusive, no-charge, royalty-free, irrevocable - copyright license to reproduce, prepare Derivative Works of, - publicly display, publicly perform, sublicense, and distribute the - Work and such Derivative Works in Source or Object form. - - 3. Grant of Patent License. Subject to the terms and conditions of - this License, each Contributor hereby grants to You a perpetual, - worldwide, non-exclusive, no-charge, royalty-free, irrevocable - (except as stated in this section) patent license to make, have made, - use, offer to sell, sell, import, and otherwise transfer the Work, - where such license applies only to those patent claims licensable - by such Contributor that are necessarily infringed by their - Contribution(s) alone or by combination of their Contribution(s) - with the Work to which such Contribution(s) was submitted. If You - institute patent litigation against any entity (including a - cross-claim or counterclaim in a lawsuit) alleging that the Work - or a Contribution incorporated within the Work constitutes direct - or contributory patent infringement, then any patent licenses - granted to You under this License for that Work shall terminate - as of the date such litigation is filed. - - 4. Redistribution. You may reproduce and distribute copies of the - Work or Derivative Works thereof in any medium, with or without - modifications, and in Source or Object form, provided that You - meet the following conditions: - - (a) You must give any other recipients of the Work or - Derivative Works a copy of this License; and - - (b) You must cause any modified files to carry prominent notices - stating that You changed the files; and - - (c) You must retain, in the Source form of any Derivative Works - that You distribute, all copyright, patent, trademark, and - attribution notices from the Source form of the Work, - excluding those notices that do not pertain to any part of - the Derivative Works; and - - (d) If the Work includes a "NOTICE" text file as part of its - distribution, then any Derivative Works that You distribute must - include a readable copy of the attribution notices contained - within such NOTICE file, excluding those notices that do not - pertain to any part of the Derivative Works, in at least one - of the following places: within a NOTICE text file distributed - as part of the Derivative Works; within the Source form or - documentation, if provided along with the Derivative Works; or, - within a display generated by the Derivative Works, if and - wherever such third-party notices normally appear. The contents - of the NOTICE file are for informational purposes only and - do not modify the License. You may add Your own attribution - notices within Derivative Works that You distribute, alongside - or as an addendum to the NOTICE text from the Work, provided - that such additional attribution notices cannot be construed - as modifying the License. - - You may add Your own copyright statement to Your modifications and - may provide additional or different license terms and conditions - for use, reproduction, or distribution of Your modifications, or - for any such Derivative Works as a whole, provided Your use, - reproduction, and distribution of the Work otherwise complies with - the conditions stated in this License. - - 5. Submission of Contributions. Unless You explicitly state otherwise, - any Contribution intentionally submitted for inclusion in the Work - by You to the Licensor shall be under the terms and conditions of - this License, without any additional terms or conditions. - Notwithstanding the above, nothing herein shall supersede or modify - the terms of any separate license agreement you may have executed - with Licensor regarding such Contributions. - - 6. Trademarks. This License does not grant permission to use the trade - names, trademarks, service marks, or product names of the Licensor, - except as required for reasonable and customary use in describing the - origin of the Work and reproducing the content of the NOTICE file. - - 7. Disclaimer of Warranty. Unless required by applicable law or - agreed to in writing, Licensor provides the Work (and each - Contributor provides its Contributions) on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or - implied, including, without limitation, any warranties or conditions - of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A - PARTICULAR PURPOSE. You are solely responsible for determining the - appropriateness of using or redistributing the Work and assume any - risks associated with Your exercise of permissions under this License. - - 8. Limitation of Liability. In no event and under no legal theory, - whether in tort (including negligence), contract, or otherwise, - unless required by applicable law (such as deliberate and grossly - negligent acts) or agreed to in writing, shall any Contributor be - liable to You for damages, including any direct, indirect, special, - incidental, or consequential damages of any character arising as a - result of this License or out of the use or inability to use the - Work (including but not limited to damages for loss of goodwill, - work stoppage, computer failure or malfunction, or any and all - other commercial damages or losses), even if such Contributor - has been advised of the possibility of such damages. - - 9. Accepting Warranty or Additional Liability. While redistributing - the Work or Derivative Works thereof, You may choose to offer, - and charge a fee for, acceptance of support, warranty, indemnity, - or other liability obligations and/or rights consistent with this - License. However, in accepting such obligations, You may act only - on Your own behalf and on Your sole responsibility, not on behalf - of any other Contributor, and only if You agree to indemnify, - defend, and hold each Contributor harmless for any liability - incurred by, or claims asserted against, such Contributor by reason - of your accepting any such warranty or additional liability. - - --------------------------------------------------------------------------------- -Dependency : github.com/awslabs/goformation/v7 -Version: v7.14.9 -Licence type (autodetected): Apache-2.0 --------------------------------------------------------------------------------- - -Contents of probable licence file $GOMODCACHE/github.com/awslabs/goformation/v7@v7.14.9/LICENSE: - - Apache License - Version 2.0, January 2004 - http://www.apache.org/licenses/ - - TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION - - 1. Definitions. - - "License" shall mean the terms and conditions for use, reproduction, - and distribution as defined by Sections 1 through 9 of this document. - - "Licensor" shall mean the copyright owner or entity authorized by - the copyright owner that is granting the License. - - "Legal Entity" shall mean the union of the acting entity and all - other entities that control, are controlled by, or are under common - control with that entity. For the purposes of this definition, - "control" means (i) the power, direct or indirect, to cause the - direction or management of such entity, whether by contract or - otherwise, or (ii) ownership of fifty percent (50%) or more of the - outstanding shares, or (iii) beneficial ownership of such entity. - - "You" (or "Your") shall mean an individual or Legal Entity - exercising permissions granted by this License. - - "Source" form shall mean the preferred form for making modifications, - including but not limited to software source code, documentation - source, and configuration files. - - "Object" form shall mean any form resulting from mechanical - transformation or translation of a Source form, including but - not limited to compiled object code, generated documentation, - and conversions to other media types. - - "Work" shall mean the work of authorship, whether in Source or - Object form, made available under the License, as indicated by a - copyright notice that is included in or attached to the work - (an example is provided in the Appendix below). - - "Derivative Works" shall mean any work, whether in Source or Object - form, that is based on (or derived from) the Work and for which the - editorial revisions, annotations, elaborations, or other modifications - represent, as a whole, an original work of authorship. For the purposes - of this License, Derivative Works shall not include works that remain - separable from, or merely link (or bind by name) to the interfaces of, - the Work and Derivative Works thereof. - - "Contribution" shall mean any work of authorship, including - the original version of the Work and any modifications or additions - to that Work or Derivative Works thereof, that is intentionally - submitted to Licensor for inclusion in the Work by the copyright owner - or by an individual or Legal Entity authorized to submit on behalf of - the copyright owner. For the purposes of this definition, "submitted" - means any form of electronic, verbal, or written communication sent - to the Licensor or its representatives, including but not limited to - communication on electronic mailing lists, source code control systems, - and issue tracking systems that are managed by, or on behalf of, the - Licensor for the purpose of discussing and improving the Work, but - excluding communication that is conspicuously marked or otherwise - designated in writing by the copyright owner as "Not a Contribution." - - "Contributor" shall mean Licensor and any individual or Legal Entity - on behalf of whom a Contribution has been received by Licensor and - subsequently incorporated within the Work. - - 2. Grant of Copyright License. Subject to the terms and conditions of - this License, each Contributor hereby grants to You a perpetual, - worldwide, non-exclusive, no-charge, royalty-free, irrevocable - copyright license to reproduce, prepare Derivative Works of, - publicly display, publicly perform, sublicense, and distribute the - Work and such Derivative Works in Source or Object form. - - 3. Grant of Patent License. Subject to the terms and conditions of - this License, each Contributor hereby grants to You a perpetual, - worldwide, non-exclusive, no-charge, royalty-free, irrevocable - (except as stated in this section) patent license to make, have made, - use, offer to sell, sell, import, and otherwise transfer the Work, - where such license applies only to those patent claims licensable - by such Contributor that are necessarily infringed by their - Contribution(s) alone or by combination of their Contribution(s) - with the Work to which such Contribution(s) was submitted. If You - institute patent litigation against any entity (including a - cross-claim or counterclaim in a lawsuit) alleging that the Work - or a Contribution incorporated within the Work constitutes direct - or contributory patent infringement, then any patent licenses - granted to You under this License for that Work shall terminate - as of the date such litigation is filed. - - 4. Redistribution. You may reproduce and distribute copies of the - Work or Derivative Works thereof in any medium, with or without - modifications, and in Source or Object form, provided that You - meet the following conditions: - - (a) You must give any other recipients of the Work or - Derivative Works a copy of this License; and - - (b) You must cause any modified files to carry prominent notices - stating that You changed the files; and - - (c) You must retain, in the Source form of any Derivative Works - that You distribute, all copyright, patent, trademark, and - attribution notices from the Source form of the Work, - excluding those notices that do not pertain to any part of - the Derivative Works; and - - (d) If the Work includes a "NOTICE" text file as part of its - distribution, then any Derivative Works that You distribute must - include a readable copy of the attribution notices contained - within such NOTICE file, excluding those notices that do not - pertain to any part of the Derivative Works, in at least one - of the following places: within a NOTICE text file distributed - as part of the Derivative Works; within the Source form or - documentation, if provided along with the Derivative Works; or, - within a display generated by the Derivative Works, if and - wherever such third-party notices normally appear. The contents - of the NOTICE file are for informational purposes only and - do not modify the License. You may add Your own attribution - notices within Derivative Works that You distribute, alongside - or as an addendum to the NOTICE text from the Work, provided - that such additional attribution notices cannot be construed - as modifying the License. - - You may add Your own copyright statement to Your modifications and - may provide additional or different license terms and conditions - for use, reproduction, or distribution of Your modifications, or - for any such Derivative Works as a whole, provided Your use, - reproduction, and distribution of the Work otherwise complies with - the conditions stated in this License. - - 5. Submission of Contributions. Unless You explicitly state otherwise, - any Contribution intentionally submitted for inclusion in the Work - by You to the Licensor shall be under the terms and conditions of - this License, without any additional terms or conditions. - Notwithstanding the above, nothing herein shall supersede or modify - the terms of any separate license agreement you may have executed - with Licensor regarding such Contributions. - - 6. Trademarks. This License does not grant permission to use the trade - names, trademarks, service marks, or product names of the Licensor, - except as required for reasonable and customary use in describing the - origin of the Work and reproducing the content of the NOTICE file. - - 7. Disclaimer of Warranty. Unless required by applicable law or - agreed to in writing, Licensor provides the Work (and each - Contributor provides its Contributions) on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or - implied, including, without limitation, any warranties or conditions - of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A - PARTICULAR PURPOSE. You are solely responsible for determining the - appropriateness of using or redistributing the Work and assume any - risks associated with Your exercise of permissions under this License. - - 8. Limitation of Liability. In no event and under no legal theory, - whether in tort (including negligence), contract, or otherwise, - unless required by applicable law (such as deliberate and grossly - negligent acts) or agreed to in writing, shall any Contributor be - liable to You for damages, including any direct, indirect, special, - incidental, or consequential damages of any character arising as a - result of this License or out of the use or inability to use the - Work (including but not limited to damages for loss of goodwill, - work stoppage, computer failure or malfunction, or any and all - other commercial damages or losses), even if such Contributor - has been advised of the possibility of such damages. - - 9. Accepting Warranty or Additional Liability. While redistributing - the Work or Derivative Works thereof, You may choose to offer, - and charge a fee for, acceptance of support, warranty, indemnity, - or other liability obligations and/or rights consistent with this - License. However, in accepting such obligations, You may act only - on Your own behalf and on Your sole responsibility, not on behalf - of any other Contributor, and only if You agree to indemnify, - defend, and hold each Contributor harmless for any liability - incurred by, or claims asserted against, such Contributor by reason - of your accepting any such warranty or additional liability. - - END OF TERMS AND CONDITIONS - - APPENDIX: How to apply the Apache License to your work. - - To apply the Apache License to your work, attach the following - boilerplate notice, with the fields enclosed by brackets "{}" - replaced with your own identifying information. (Don't include - the brackets!) The text should be enclosed in the appropriate - comment syntax for the file format. We also recommend that a - file or class name and description of purpose be included on the - same "printed page" as the copyright notice for easier - identification within third-party archives. - - Copyright {yyyy} {name of copyright owner} - - 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 - - http://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. - - --------------------------------------------------------------------------------- -Dependency : github.com/awslabs/kinesis-aggregation/go/v2 -Version: v2.0.0-20220623125934-28468a6701b5 -Licence type (autodetected): Apache-2.0 --------------------------------------------------------------------------------- - -No licence file provided. -------------------------------------------------------------------------------- Dependency : github.com/blakesmith/ar diff --git a/README.md b/README.md index 417436490c2..fff2a7527db 100644 --- a/README.md +++ b/README.md @@ -20,7 +20,6 @@ Beat | Description --- | --- [Auditbeat](https://github.com/elastic/beats/tree/main/auditbeat) | Collect your Linux audit framework data and monitor the integrity of your files. [Filebeat](https://github.com/elastic/beats/tree/main/filebeat) | Tails and ships log files -[Functionbeat](https://github.com/elastic/beats/tree/main/x-pack/functionbeat) | Read and ships events from serverless infrastructure. [Heartbeat](https://github.com/elastic/beats/tree/main/heartbeat) | Ping remote services for availability [Metricbeat](https://github.com/elastic/beats/tree/main/metricbeat) | Fetches sets of metrics from the operating system and services [Packetbeat](https://github.com/elastic/beats/tree/main/packetbeat) | Monitors the network and applications by sniffing packets @@ -41,7 +40,6 @@ on the [elastic.co site](https://www.elastic.co/guide/): * [Beats platform](https://www.elastic.co/guide/en/beats/libbeat/current/index.html) * [Auditbeat](https://www.elastic.co/guide/en/beats/auditbeat/current/index.html) * [Filebeat](https://www.elastic.co/guide/en/beats/filebeat/current/index.html) -* [Functionbeat](https://www.elastic.co/guide/en/beats/functionbeat/current/index.html) * [Heartbeat](https://www.elastic.co/guide/en/beats/heartbeat/current/index.html) * [Metricbeat](https://www.elastic.co/guide/en/beats/metricbeat/current/index.html) * [Packetbeat](https://www.elastic.co/guide/en/beats/packetbeat/current/index.html) diff --git a/dev-tools/cmd/update_go/update_go_version.go b/dev-tools/cmd/update_go/update_go_version.go index f589abc756d..df7f74747c1 100644 --- a/dev-tools/cmd/update_go/update_go_version.go +++ b/dev-tools/cmd/update_go/update_go_version.go @@ -34,7 +34,6 @@ var files = []string{ "libbeat/docs/version.asciidoc", "metricbeat/Dockerfile", "metricbeat/module/http/_meta/Dockerfile", - "x-pack/functionbeat/Dockerfile", "x-pack/libbeat/Dockerfile", } diff --git a/docs/devguide/documentation.asciidoc b/docs/devguide/documentation.asciidoc index d81f79ccb40..82e12a2721b 100644 --- a/docs/devguide/documentation.asciidoc +++ b/docs/devguide/documentation.asciidoc @@ -69,7 +69,7 @@ doc collector scripts to regenerate the docs. Make sure you <> and use the correct Go version. The Go version is listed in the `version.asciidoc` file -for the branch you want to update. +for the branch you want to update. To run the docs collector scripts, change to the beats directory and run: @@ -108,7 +108,6 @@ generates * `auditbeat/docs/fields.asciidoc` * `filebeat/docs/fields.asciidoc` -* `functionbeat/docs/fields.asciidoc` * `heartbeat/docs/fields.asciidoc` * `metricbeat/docs/fields.asciidoc` * `packetbeat/docs/fields.asciidoc` diff --git a/go.mod b/go.mod index be5cc26cb32..2e25c7c9de0 100644 --- a/go.mod +++ b/go.mod @@ -10,7 +10,7 @@ require ( code.cloudfoundry.org/go-loggregator v7.4.0+incompatible code.cloudfoundry.org/rfc5424 v0.0.0-20180905210152-236a6d29298a // indirect github.com/Azure/azure-event-hubs-go/v3 v3.6.1 - github.com/Azure/azure-sdk-for-go v65.0.0+incompatible + github.com/Azure/azure-sdk-for-go v68.0.0+incompatible github.com/Azure/go-ansiterm v0.0.0-20230124172434-306776ec8161 // indirect github.com/Azure/go-autorest/autorest v0.11.29 github.com/Azure/go-autorest/autorest/date v0.3.0 @@ -22,7 +22,6 @@ require ( github.com/akavel/rsrc v0.8.0 // indirect github.com/apoydence/eachers v0.0.0-20181020210610-23942921fe77 // indirect github.com/armon/go-socks5 v0.0.0-20160902184237-e75332964ef5 - github.com/aws/aws-lambda-go v1.44.0 github.com/aws/aws-sdk-go-v2 v1.30.5 github.com/aws/aws-sdk-go-v2/config v1.27.29 github.com/aws/aws-sdk-go-v2/credentials v1.17.29 @@ -172,12 +171,8 @@ require ( github.com/aws/aws-sdk-go-v2/feature/s3/manager v1.17.13 github.com/aws/aws-sdk-go-v2/service/apigateway v1.25.8 github.com/aws/aws-sdk-go-v2/service/apigatewayv2 v1.22.8 - github.com/aws/aws-sdk-go-v2/service/cloudformation v1.53.5 github.com/aws/aws-sdk-go-v2/service/health v1.26.4 - github.com/aws/aws-sdk-go-v2/service/kinesis v1.29.5 github.com/aws/smithy-go v1.20.4 - github.com/awslabs/goformation/v7 v7.14.9 - github.com/awslabs/kinesis-aggregation/go/v2 v2.0.0-20220623125934-28468a6701b5 github.com/dgraph-io/badger/v4 v4.4.0 github.com/elastic/bayeux v1.0.5 github.com/elastic/ebpfevents v0.6.0 @@ -353,6 +348,8 @@ require ( github.com/morikuni/aec v1.0.0 // indirect github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822 // indirect github.com/mxk/go-flowrate v0.0.0-20140419014527-cca7078d478f // indirect + github.com/onsi/ginkgo/v2 v2.17.1 // indirect + github.com/onsi/gomega v1.33.0 // indirect github.com/opencontainers/go-digest v1.0.0 // indirect github.com/opencontainers/image-spec v1.1.0 // indirect github.com/pkg/browser v0.0.0-20240102092130-5ac0b6a4141c // indirect diff --git a/go.sum b/go.sum index 6d5130c8951..cbf4b3eab9e 100644 --- a/go.sum +++ b/go.sum @@ -46,8 +46,8 @@ github.com/Azure/azure-event-hubs-go/v3 v3.6.1 h1:vSiMmn3tOwgiLyfnmhT5K6Of/3QWRL github.com/Azure/azure-event-hubs-go/v3 v3.6.1/go.mod h1:i2NByb9Pr2na7y8wi/XefEVKkuA2CDUjCNoWQJtTsGo= github.com/Azure/azure-pipeline-go v0.2.3 h1:7U9HBg1JFK3jHl5qmo4CTZKFTVgMwdFHMVtCdfBE21U= github.com/Azure/azure-pipeline-go v0.2.3/go.mod h1:x841ezTBIMG6O3lAcl8ATHnsOPVl2bqk7S3ta6S6u4k= -github.com/Azure/azure-sdk-for-go v65.0.0+incompatible h1:HzKLt3kIwMm4KeJYTdx9EbjRYTySD/t8i1Ee/W5EGXw= -github.com/Azure/azure-sdk-for-go v65.0.0+incompatible/go.mod h1:9XXNKU+eRnpl9moKnB4QOLf1HestfXbmab5FXxiDBjc= +github.com/Azure/azure-sdk-for-go v68.0.0+incompatible h1:fcYLmCpyNYRnvJbPerq7U0hS+6+I79yEDJBqVNcqUzU= +github.com/Azure/azure-sdk-for-go v68.0.0+incompatible/go.mod h1:9XXNKU+eRnpl9moKnB4QOLf1HestfXbmab5FXxiDBjc= github.com/Azure/azure-sdk-for-go/sdk/azcore v1.13.0 h1:GJHeeA2N7xrG3q30L2UXDyuWRzDM900/65j70wcM4Ww= github.com/Azure/azure-sdk-for-go/sdk/azcore v1.13.0/go.mod h1:l38EPgmsp71HHLq9j7De57JcKOWPyhrsW1Awm1JS6K0= github.com/Azure/azure-sdk-for-go/sdk/azidentity v1.7.0 h1:tfLQ34V6F7tVSwoTf/4lH5sE0o6eCJuNDTmH09nDpbc= @@ -155,9 +155,6 @@ github.com/armon/go-radix v1.0.0 h1:F4z6KzEeeQIMeLFa97iZU6vupzoecKdU5TX24SNppXI= github.com/armon/go-radix v1.0.0/go.mod h1:ufUuZ+zHj4x4TnLV4JWEpy2hxWSpsRywHrMgIH9cCH8= github.com/armon/go-socks5 v0.0.0-20160902184237-e75332964ef5 h1:0CwZNZbxp69SHPdPJAN/hZIm0C4OItdklCFmMRWYpio= github.com/armon/go-socks5 v0.0.0-20160902184237-e75332964ef5/go.mod h1:wHh0iHkYZB8zMSxRWpUBQtwG5a7fFgvEO+odwuTv2gs= -github.com/aws/aws-lambda-go v1.44.0 h1:Xp9PANXKsSJ23IhE4ths592uWTCEewswPhSH9qpAuQQ= -github.com/aws/aws-lambda-go v1.44.0/go.mod h1:dpMpZgvWx5vuQJfBt0zqBha60q7Dd7RfgJv23DymV8A= -github.com/aws/aws-sdk-go-v2 v1.9.0/go.mod h1:cK/D0BBs0b/oWPIcX/Z/obahJK1TT7IPVjy53i/mX/4= github.com/aws/aws-sdk-go-v2 v1.30.5 h1:mWSRTwQAb0aLE17dSzztCVJWI9+cRMgqebndjwDyK0g= github.com/aws/aws-sdk-go-v2 v1.30.5/go.mod h1:CT+ZPWXbYrci8chcARI3OmI/qgd+f6WtuLOoaIA8PR0= github.com/aws/aws-sdk-go-v2/aws/protocol/eventstream v1.6.4 h1:70PVAiL15/aBMh5LThwgXdSQorVr91L127ttckI9QQU= @@ -182,8 +179,6 @@ github.com/aws/aws-sdk-go-v2/service/apigateway v1.25.8 h1:CgEyY7gfTf7lHYcCi7+w6 github.com/aws/aws-sdk-go-v2/service/apigateway v1.25.8/go.mod h1:z99ur4Ha5540t8hb5XtqV/UMOnEoEZK22lhr5ZBS0zw= github.com/aws/aws-sdk-go-v2/service/apigatewayv2 v1.22.8 h1:SWBNBbVbThg5Hdi3hWbVaDFjV/OyPbuqZLu4N+mj/Es= github.com/aws/aws-sdk-go-v2/service/apigatewayv2 v1.22.8/go.mod h1:lz2IT8gzzSwao0Pa6uMSdCIPsprmgCkW83q6sHGZFDw= -github.com/aws/aws-sdk-go-v2/service/cloudformation v1.53.5 h1:YeTVIy7cJLeahs7K0jQGDGAd1YYND/to/z8N3kqZBhY= -github.com/aws/aws-sdk-go-v2/service/cloudformation v1.53.5/go.mod h1:y45SdA9v+dLlweaqwAQMoFeXqdRvgwevafa2X8iTqZQ= github.com/aws/aws-sdk-go-v2/service/cloudwatch v1.40.5 h1:/YvqO1j75i4leoV+Z3a5s/dAlEszf2wTKBW8jc3Gd4s= github.com/aws/aws-sdk-go-v2/service/cloudwatch v1.40.5/go.mod h1:maEDlnDRdhsc0xrUljh3dUJbej11AHz+VTQJsNw1QmE= github.com/aws/aws-sdk-go-v2/service/cloudwatchlogs v1.37.5 h1:cQpWa19MrnwPcHQfDjLy6GJLo6lpgbMNix4pt5zLuK0= @@ -206,9 +201,6 @@ github.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.11.18 h1:tJ5RnkHC github.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.11.18/go.mod h1:++NHzT+nAF7ZPrHPsA+ENvsXkOO8wEu+C6RXltAG4/c= github.com/aws/aws-sdk-go-v2/service/internal/s3shared v1.17.16 h1:jg16PhLPUiHIj8zYIW6bqzeQSuHVEiWnGA0Brz5Xv2I= github.com/aws/aws-sdk-go-v2/service/internal/s3shared v1.17.16/go.mod h1:Uyk1zE1VVdsHSU7096h/rwnXDzOzYQVl+FNPhPw7ShY= -github.com/aws/aws-sdk-go-v2/service/kinesis v1.6.0/go.mod h1:9O7UG2pELnP0hq35+Gd7XDjOLBkg7tmgRQ0y14ZjoJI= -github.com/aws/aws-sdk-go-v2/service/kinesis v1.29.5 h1:iirGMva2IXw4kcqsvuF+uc8ARweuVqoQJjzRZGaiV1E= -github.com/aws/aws-sdk-go-v2/service/kinesis v1.29.5/go.mod h1:pKTvEQz1PcNd+gKArVyeHpVM63AWnFqYyg07WAQQANQ= github.com/aws/aws-sdk-go-v2/service/organizations v1.30.3 h1:gYS53GRIaSesL04BlZA9MEBzDlENidWR/JDBXhZonFs= github.com/aws/aws-sdk-go-v2/service/organizations v1.30.3/go.mod h1:qdJX3WZbuAan5dXCoinnJjuY1QERCpv3glXeI3+wbeA= github.com/aws/aws-sdk-go-v2/service/rds v1.82.2 h1:kO/fQcueYZvuL5kPzTPQ503cKZj8jyBNg1MlnIqpFPg= @@ -225,13 +217,8 @@ github.com/aws/aws-sdk-go-v2/service/ssooidc v1.26.5 h1:SKvPgvdvmiTWoi0GAJ7AsJfO github.com/aws/aws-sdk-go-v2/service/ssooidc v1.26.5/go.mod h1:20sz31hv/WsPa3HhU3hfrIet2kxM4Pe0r20eBZ20Tac= github.com/aws/aws-sdk-go-v2/service/sts v1.30.5 h1:OMsEmCyz2i89XwRwPouAJvhj81wINh+4UK+k/0Yo/q8= github.com/aws/aws-sdk-go-v2/service/sts v1.30.5/go.mod h1:vmSqFK+BVIwVpDAGZB3CoCXHzurt4qBE8lf+I/kRTh0= -github.com/aws/smithy-go v1.8.0/go.mod h1:SObp3lf9smib00L/v3U2eAKG8FyQ7iLrJnQiAmR5n+E= github.com/aws/smithy-go v1.20.4 h1:2HK1zBdPgRbjFOHlfeQZfpC4r72MOb9bZkiFwggKO+4= github.com/aws/smithy-go v1.20.4/go.mod h1:irrKGvNn1InZwb2d7fkIRNucdfwR8R+Ts3wxYa/cJHg= -github.com/awslabs/goformation/v7 v7.14.9 h1:sZjjpTqXrcBDz4Fi07JWTT7zKM68XsQkW/7iLAJbA/M= -github.com/awslabs/goformation/v7 v7.14.9/go.mod h1:7obldQ8NQ/AkMsgL5K3l4lRMDFB6kCGUloz5dURcXIs= -github.com/awslabs/kinesis-aggregation/go/v2 v2.0.0-20220623125934-28468a6701b5 h1:lxW5Q6K2IisyF5tlr6Ts0W4POGWQZco05MJjFmoeIHs= -github.com/awslabs/kinesis-aggregation/go/v2 v2.0.0-20220623125934-28468a6701b5/go.mod h1:0Qr1uMHFmHsIYMcG4T7BJ9yrJtWadhOmpABCX69dwuc= github.com/benbjohnson/clock v1.1.0/go.mod h1:J11/hYXuz8f4ySSvYwY0FKfm+ezbsZBKZxNJlLklBHA= github.com/benbjohnson/clock v1.3.0 h1:ip6w0uFQkncKQ979AypyG0ER7mqUSBdKLOgAle/AT8A= github.com/benbjohnson/clock v1.3.0/go.mod h1:J11/hYXuz8f4ySSvYwY0FKfm+ezbsZBKZxNJlLklBHA= @@ -507,7 +494,6 @@ github.com/golang/protobuf v1.4.0/go.mod h1:jodUvKwWbYaEsadDk5Fwe5c77LiNKVO9IDvq github.com/golang/protobuf v1.4.1/go.mod h1:U8fpvMrcmy5pZrNK1lt4xCsGvpyWQ/VVv6QDs8UjoX8= github.com/golang/protobuf v1.4.3/go.mod h1:oDoupMAO8OvCJWAcko0GGGIgR6R6ocIYbsSw735rRwI= github.com/golang/protobuf v1.5.0/go.mod h1:FsONVRAS9T7sI+LIUmWTfcYkHO4aIWwzhcaSAoJOfIk= -github.com/golang/protobuf v1.5.2/go.mod h1:XVQd3VNwM+JqD3oG2Ue2ip4fOMUkwXdXDdiuN0vRsmY= github.com/golang/protobuf v1.5.4 h1:i7eJL8qZTpSEXOPTxNKhASYpMn+8e5Q6AdndVa1dWek= github.com/golang/protobuf v1.5.4/go.mod h1:lnTiLA8Wa4RWRcIUkrtSVa5nRhsEGBg48fD6rSs7xps= github.com/golang/snappy v0.0.4 h1:yAGX7huGHXlcLOEtBnF4w7FQwA26wojNCwOYAEhLjQM= @@ -527,7 +513,6 @@ github.com/google/go-cmp v0.4.0/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/ github.com/google/go-cmp v0.5.0/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= github.com/google/go-cmp v0.5.2/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= github.com/google/go-cmp v0.5.3/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= -github.com/google/go-cmp v0.5.4/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= github.com/google/go-cmp v0.5.5/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= github.com/google/go-cmp v0.5.6/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= github.com/google/go-cmp v0.5.8/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY= @@ -1191,7 +1176,6 @@ google.golang.org/protobuf v1.23.0/go.mod h1:EGpADcykh3NcUnDUJcl1+ZksZNG86OlYog2 google.golang.org/protobuf v1.23.1-0.20200526195155-81db48ad09cc/go.mod h1:EGpADcykh3NcUnDUJcl1+ZksZNG86OlYog2l/sGQquU= google.golang.org/protobuf v1.25.0/go.mod h1:9JNX74DMeImyA3h4bdi1ymwjUzf21/xIlbajtzgsN7c= google.golang.org/protobuf v1.26.0-rc.1/go.mod h1:jlhhOSvTdKEhbULTjvd4ARK9grFBp09yW+WbY/TyQbw= -google.golang.org/protobuf v1.26.0/go.mod h1:9q0QmTI4eRPtz6boOQmLYwt+qCgq0jsYwAQnmE0givc= google.golang.org/protobuf v1.27.1/go.mod h1:9q0QmTI4eRPtz6boOQmLYwt+qCgq0jsYwAQnmE0givc= google.golang.org/protobuf v1.34.2 h1:6xV6lTsCfpGD21XK49h7MhtcApnLqkfYgPcdHftf6hg= google.golang.org/protobuf v1.34.2/go.mod h1:qYOHts0dSfpeUzUFpOMr/WGzszTmLH+DiWniOlNbLDw= diff --git a/libbeat/docs/command-reference.asciidoc b/libbeat/docs/command-reference.asciidoc index 91daaf097be..4766152f39f 100644 --- a/libbeat/docs/command-reference.asciidoc +++ b/libbeat/docs/command-reference.asciidoc @@ -103,9 +103,6 @@ more information, see https://www.elastic.co/subscriptions and [options="header"] |======================= |Commands | -ifeval::["{beatname_lc}"=="functionbeat"] -|<> | {deploy-command-short-desc}. -endif::[] ifdef::apm-server[] |<> |{apikey-command-short-desc}. endif::[] @@ -114,10 +111,6 @@ endif::[] ifndef::serverless[] |<> |{keystore-command-short-desc}. endif::[] -ifeval::["{beatname_lc}"=="functionbeat"] -|<> |{package-command-short-desc}. -|<> |{remove-command-short-desc}. -endif::[] ifdef::has_modules_command[] |<> |{modules-command-short-desc}. endif::[] @@ -126,9 +119,6 @@ ifndef::serverless[] endif::[] |<> |{setup-command-short-desc}. |<> |{test-command-short-desc}. -ifeval::["{beatname_lc}"=="functionbeat"] -|<> |{update-command-short-desc}. -endif::[] |<> |{version-command-short-desc}. |======================= @@ -232,39 +222,6 @@ For more information, see <>. endif::[] -ifeval::["{beatname_lc}"=="functionbeat"] -[[deploy-command]] -==== `deploy` command - -{deploy-command-short-desc}. Before deploying functions, make sure the user has -the credentials required by your cloud service provider. - -*SYNOPSIS* - -["source","sh",subs="attributes"] ----- -{beatname_lc} deploy FUNCTION_NAME [FLAGS] ----- - -*`FUNCTION_NAME`*:: -Specifies the name of the function to deploy. - -*FLAGS* - -*`-h, --help`*:: -Shows help for the `deploy` command. - -{global-flags} - -*EXAMPLES* - -["source","sh",subs="attributes"] ------ -{beatname_lc} deploy cloudwatch -{beatname_lc} deploy sqs ------ -endif::[] - [[export-command]] ==== `export` command @@ -521,68 +478,6 @@ See <> for more examples. endif::[] -ifeval::["{beatname_lc}"=="functionbeat"] -[[package-command]] -==== `package` command - -{package-command-short-desc}. - -*SYNOPSIS* - -["source","sh",subs="attributes"] ----- -{beatname_lc} package [FLAGS] ----- - -*FLAGS* - -*`-h, --help`*:: -Shows help for the `package` command. - -*`-o, --output`*:: -Specifies the full path pattern to use when creating the packages. - -{global-flags} - -*EXAMPLES* - -["source","sh",subs="attributes"] ------ -{beatname_lc} package --output /path/to/folder/package-{{.Provider}}.zip ------ - -[[remove-command]] -==== `remove` command - -{remove-command-short-desc}. Before removing functions, make sure the user has -the credentials required by your cloud service provider. - -*SYNOPSIS* - -["source","sh",subs="attributes"] ----- -{beatname_lc} remove FUNCTION_NAME [FLAGS] ----- - -*`FUNCTION_NAME`*:: -Specifies the name of the function to remove. - -*FLAGS* - -*`-h, --help`*:: -Shows help for the `remove` command. - -{global-flags} - -*EXAMPLES* - -["source","sh",subs="attributes"] ------ -{beatname_lc} remove cloudwatch -{beatname_lc} remove sqs ------ -endif::[] - ifdef::has_modules_command[] [[modules-command]] ==== `modules` command @@ -748,7 +643,7 @@ endif::[] *`--system.hostfs MOUNT_POINT`*:: -Specifies the mount point of the host's filesystem for use in monitoring a host. +Specifies the mount point of the host's filesystem for use in monitoring a host. This flag is depricated, and an alternate hostfs should be specified via the `hostfs` module config value. @@ -961,39 +856,6 @@ ifeval::["{beatname_lc}"=="metricbeat"] ----- endif::[] -ifeval::["{beatname_lc}"=="functionbeat"] -[[update-command]] -==== `update` command - -{update-command-short-desc}. Before updating functions, make sure the user has -the credentials required by your cloud service provider. - -*SYNOPSIS* - -["source","sh",subs="attributes"] ----- -{beatname_lc} update FUNCTION_NAME [FLAGS] ----- - -*`FUNCTION_NAME`*:: -Specifies the name of the function to update. - -*FLAGS* - -*`-h, --help`*:: -Shows help for the `update` command. - -{global-flags} - -*EXAMPLES* - -["source","sh",subs="attributes"] ------ -{beatname_lc} update cloudwatch -{beatname_lc} update sqs ------ -endif::[] - [[version-command]] ==== `version` command diff --git a/libbeat/docs/overview.asciidoc b/libbeat/docs/overview.asciidoc index c76aa8558e5..d42f3e904eb 100644 --- a/libbeat/docs/overview.asciidoc +++ b/libbeat/docs/overview.asciidoc @@ -9,7 +9,6 @@ for capturing: [horizontal] Audit data:: https://www.elastic.co/products/beats/auditbeat[Auditbeat] Log files and journals:: https://www.elastic.co/products/beats/filebeat[Filebeat] -Cloud data:: https://www.elastic.co/products/beats/functionbeat[Functionbeat] Availability:: https://www.elastic.co/products/beats/heartbeat[Heartbeat] Metrics:: https://www.elastic.co/products/beats/metricbeat[Metricbeat] Network traffic:: https://www.elastic.co/products/beats/packetbeat[Packetbeat] diff --git a/libbeat/publisher/pipeline/sync_client.go b/libbeat/publisher/pipeline/sync_client.go deleted file mode 100644 index 9dcf69ff155..00000000000 --- a/libbeat/publisher/pipeline/sync_client.go +++ /dev/null @@ -1,106 +0,0 @@ -// Licensed to Elasticsearch B.V. under one or more contributor -// license agreements. See the NOTICE file distributed with -// this work for additional information regarding copyright -// ownership. Elasticsearch B.V. licenses this file to you 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 -// -// http://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. - -package pipeline - -import ( - "sync" - - "github.com/elastic/beats/v7/libbeat/beat" - "github.com/elastic/beats/v7/libbeat/common/acker" - "github.com/elastic/beats/v7/libbeat/publisher/pipetool" - "github.com/elastic/elastic-agent-libs/logp" -) - -// Client implements the interface used by all the functionbeat function, we only implement a synchronous -// client. This interface superseed the core beat.Client interface and can return errors on publish. -type ISyncClient interface { - // Publish accepts a unique events and will publish it to the pipeline. - Publish(beat.Event) error - - // PublishAll accepts a list of multiple events and will publish them to the pipeline. - PublishAll([]beat.Event) error - - // Close closes the current client, no events will be accepted, this method can block if we still - // need to ACK on events. - Close() error - - // Wait blocks until the publisher pipeline send the ACKS for all the events. - Wait() -} - -// SyncClient wraps an existing beat.Client and provide a sync interface. -type SyncClient struct { - client beat.Client - wg sync.WaitGroup - log *logp.Logger -} - -// NewSyncClient creates a new sync clients from the provided configuration, existing ACKs handlers -// defined in the configuration will be proxied by this object. -func NewSyncClient(log *logp.Logger, pipeline beat.Pipeline, cfg beat.ClientConfig) (*SyncClient, error) { - if log == nil { - log = logp.NewLogger("") - } - s := &SyncClient{log: log.Named("sync client")} - - pipeline = pipetool.WithACKer(pipeline, acker.TrackingCounter(func(_, total int) { - log.Debugf("ack callback receives with events count of %d", total) - s.onACK(total) - })) - - c, err := pipeline.ConnectWith(cfg) - if err != nil { - return nil, err - } - - s.client = c - - return s, nil -} - -// Publish publishes one event to the pipeline and return. -func (s *SyncClient) Publish(event beat.Event) error { - s.log.Debug("Publish 1 event") - s.wg.Add(1) - s.client.Publish(event) - return nil -} - -// PublishAll publish a slice of events to the pipeline and return. -func (s *SyncClient) PublishAll(events []beat.Event) error { - s.log.Debugf("Publish %d events", len(events)) - s.wg.Add(len(events)) - s.client.PublishAll(events) - return nil -} - -// Close closes the wrapped beat.Client. -func (s *SyncClient) Close() error { - s.wg.Wait() - return s.client.Close() -} - -// Wait waits until we received a ACK for every events that were sent, this is useful in the -// context of serverless, because when the handler return the execution of the process is suspended. -func (s *SyncClient) Wait() { - s.wg.Wait() -} - -func (s *SyncClient) onACK(n int) { - s.wg.Add(-1 * n) -} diff --git a/libbeat/publisher/pipeline/sync_client_test.go b/libbeat/publisher/pipeline/sync_client_test.go deleted file mode 100644 index 09eac919bd5..00000000000 --- a/libbeat/publisher/pipeline/sync_client_test.go +++ /dev/null @@ -1,132 +0,0 @@ -// Licensed to Elasticsearch B.V. under one or more contributor -// license agreements. See the NOTICE file distributed with -// this work for additional information regarding copyright -// ownership. Elasticsearch B.V. licenses this file to you 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 -// -// http://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. - -package pipeline - -import ( - "testing" - - "github.com/stretchr/testify/assert" - - "github.com/elastic/beats/v7/libbeat/beat" -) - -type dummyClient struct { - Received chan int -} - -func newDummyClient() *dummyClient { - return &dummyClient{Received: make(chan int)} -} - -func (c *dummyClient) Publish(event beat.Event) { - c.Received <- 1 -} - -func (c *dummyClient) PublishAll(events []beat.Event) { - c.Received <- len(events) -} - -func (c *dummyClient) Close() error { - close(c.Received) - return nil -} - -type dummyPipeline struct { - client beat.Client -} - -func newDummyPipeline(client beat.Client) *dummyPipeline { - return &dummyPipeline{client: client} -} - -func (d *dummyPipeline) Connect() (beat.Client, error) { - return d.client, nil -} - -func (d *dummyPipeline) ConnectWith(cfg beat.ClientConfig) (beat.Client, error) { - return d.client, nil -} - -func TestSyncClient(t *testing.T) { - receiver := func(c *dummyClient, sc *SyncClient) { - i := <-c.Received - sc.onACK(i) - } - - t.Run("Publish", func(t *testing.T) { - c := newDummyClient() - - pipeline := newDummyPipeline(c) - sc, err := NewSyncClient(nil, pipeline, beat.ClientConfig{}) - if !assert.NoError(t, err) { - return - } - defer sc.Close() - - go receiver(c, sc) - - err = sc.Publish(beat.Event{}) - if !assert.NoError(t, err) { - return - } - sc.Wait() - }) - - t.Run("PublishAll single ACK", func(t *testing.T) { - c := newDummyClient() - - pipeline := newDummyPipeline(c) - sc, err := NewSyncClient(nil, pipeline, beat.ClientConfig{}) - if !assert.NoError(t, err) { - return - } - defer sc.Close() - - go receiver(c, sc) - - err = sc.PublishAll(make([]beat.Event, 10)) - if !assert.NoError(t, err) { - return - } - sc.Wait() - }) - - t.Run("PublishAll multiple independent ACKs", func(t *testing.T) { - c := newDummyClient() - - pipeline := newDummyPipeline(c) - sc, err := NewSyncClient(nil, pipeline, beat.ClientConfig{}) - if !assert.NoError(t, err) { - return - } - defer sc.Close() - - go func(c *dummyClient, sc *SyncClient) { - <-c.Received - // simulate multiple acks - sc.onACK(5) - sc.onACK(5) - }(c, sc) - - err = sc.PublishAll(make([]beat.Event, 10)) - if !assert.NoError(t, err) { - return - } - sc.Wait() - }) -} diff --git a/x-pack/functionbeat/.gitignore b/x-pack/functionbeat/.gitignore deleted file mode 100644 index e89322a2657..00000000000 --- a/x-pack/functionbeat/.gitignore +++ /dev/null @@ -1,10 +0,0 @@ -.idea -.vagrant -.vscode -/*/_meta/kibana.generated -functionbeat -functionbeat.test -build -data -logs -./fields.yml diff --git a/x-pack/functionbeat/Dockerfile b/x-pack/functionbeat/Dockerfile deleted file mode 100644 index f903da58b53..00000000000 --- a/x-pack/functionbeat/Dockerfile +++ /dev/null @@ -1,25 +0,0 @@ -FROM golang:1.22.9 - -RUN \ - apt-get update \ - && DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends \ - netcat-openbsd \ - rsync \ - python3 \ - python3-pip \ - python3-venv \ - && rm -rf /var/lib/apt/lists/* - -# Use a virtualenv to avoid the PEP668 "externally managed environment" error caused by conflicts -# with the system Python installation. golang:1.20.6 uses Debian 12 which now enforces PEP668. -ENV VIRTUAL_ENV=/opt/venv -RUN python3 -m venv $VIRTUAL_ENV -ENV PATH="$VIRTUAL_ENV/bin:$PATH" - -RUN pip3 install --upgrade pip==20.1.1 - -# Setup work environment -ENV FUNCTIONBEAT_PATH /go/src/github.com/elastic/beats/x-pack/functionbeat - -RUN mkdir -p $FUNCTIONBEAT_PATH/build/coverage -WORKDIR $FUNCTIONBEAT_PATH diff --git a/x-pack/functionbeat/Jenkinsfile.yml b/x-pack/functionbeat/Jenkinsfile.yml deleted file mode 100644 index d67e7928872..00000000000 --- a/x-pack/functionbeat/Jenkinsfile.yml +++ /dev/null @@ -1,100 +0,0 @@ -when: - branches: true ## for all the branches - changeset: ## when PR contains any of those entries in the changeset - - "^x-pack/functionbeat/.*" - - "@ci" ## special token regarding the changeset for the ci - - "@xpack" ## special token regarding the changeset for the xpack - comments: ## when PR comment contains any of those entries - - "/test x-pack/functionbeat" - labels: ## when PR labels matches any of those entries - - "x-pack-functionbeat" - parameters: ## when parameter was selected in the UI. - - "x-pack-functionbeat" - tags: true ## for all the tags -platform: "immutable && ubuntu-22" ## default label for all the stages -stages: - arm: - mage: "mage build unitTest" - platforms: ## override default label in this specific stage. - - "ubuntu-2204-aarch64" - when: ## Override the top-level when. - comments: - - "/test x-pack/functionbeat for arm" - labels: - - "arm" - parameters: - - "armTest" - stage: extended - unitTest: - mage: "mage build unitTest" - stage: mandatory - goIntegTest: - mage: "mage goIntegTest" - stage: mandatory - macos: - mage: "mage build unitTest" - platforms: ## override default label in this specific stage. - - "macos12 && x86_64" - when: ## Override the top-level when. - comments: - - "/test x-pack/functionbeat for macos" - labels: - - "macOS" - parameters: - - "macosTest" - tags: true ## for all the tags - stage: extended - macosM1: - mage: "mage build unitTest" - platforms: ## override default label in this specific stage. - - "orka && darwin && aarch64" - when: ## Override the top-level when. - comments: - - "/test functonbeat for macos-m1" - labels: - - "macos-m1" - parameters: - - "macosM1Test" - tags: false ## for all the tags - stage: extended - windows-2022: - mage: "mage build unitTest" - platforms: ## override default labels in this specific stage. - - "windows-2022" - stage: mandatory - windows-2019: - mage: "mage build unitTest" - platforms: ## override default labels in this specific stage. - - "windows-2019" - stage: extended_win - windows-2016: - mage: "mage build unitTest" - platforms: ## override default labels in this specific stage. - - "windows-2016" - stage: mandatory - windows-2012: - mage: "mage build unitTest" - platforms: ## override default labels in this specific stage. - - "windows-2012-r2" - stage: extended_win - windows-10: - mage: "mage build unitTest" - platforms: ## override default labels in this specific stage. - - "windows-10" - stage: extended_win - windows-8: - mage: "mage build unitTest" - platforms: ## override default labels in this specific stage. - - "windows-8" - stage: extended_win - packaging-linux: - packaging-linux: "mage package" - e2e: - enabled: false - stage: packaging - when: - branches: false ## Only on a PR basis for the time being - tags: false ## packaging on branches/tags is already in place with the downstream build. - changeset: ## when PR contains any of those entries in the changeset - - "^x-pack/functionbeat/.*" - - "@xpack" ## special token regarding the changeset for the xpack diff --git a/x-pack/functionbeat/Makefile b/x-pack/functionbeat/Makefile deleted file mode 100644 index be4e2ceaeb3..00000000000 --- a/x-pack/functionbeat/Makefile +++ /dev/null @@ -1,10 +0,0 @@ -# -# Variables -# -GOX_FLAGS=-arch="amd64 386 arm ppc64 ppc64le" -ES_BEATS?=../../ - -# -# Includes -# -include $(ES_BEATS)/dev-tools/make/mage.mk diff --git a/x-pack/functionbeat/_meta/config/beat.reference.yml.tmpl b/x-pack/functionbeat/_meta/config/beat.reference.yml.tmpl deleted file mode 100644 index 2f280df4c3a..00000000000 --- a/x-pack/functionbeat/_meta/config/beat.reference.yml.tmpl +++ /dev/null @@ -1,297 +0,0 @@ -########################## Functionbeat Configuration ########################### - -# This file is a full configuration example documenting all non-deprecated -# options in comments. For a shorter configuration example, that contains only -# the most common options, please see functionbeat.yml in the same directory. -# -# You can find the full configuration reference here: -# https://www.elastic.co/guide/en/beats/functionbeat/index.html - -{{header "Provider"}} -# Configure functions to run on AWS Lambda, currently, we assume that the credentials -# are present in the environment to correctly create the function when using the CLI. -# -# Configure which S3 endpoint should we use. -functionbeat.provider.aws.endpoint: "s3.amazonaws.com" -# Configure which S3 bucket we should upload the lambda artifact. -functionbeat.provider.aws.deploy_bucket: "functionbeat-deploy" - -# Configure credentials of Functionbeat while deploying to AWS. -# Available options: -# * access_key_id, secret_access_key and/or session_token -#functionbeat.provider.aws.access_key_id: '${AWS_ACCESS_KEY_ID:""}' -#functionbeat.provider.aws.secret_access_key: '${AWS_SECRET_ACCESS_KEY:""}' -#functionbeat.provider.aws.session_token: '${AWS_SESSION_TOKEN:""}' -# * role_arn -#functionbeat.provider.aws.role_arn: arn:aws:iam::123456789012:role/test-fnb -# * credential_profile_name and/or shared_credential_file -#functionbeat.provider.aws.credential_profile_name: fnb-aws -#functionbeat.provider.aws.shared_credential_file: /etc/functionbeat/aws_credentials - -functionbeat.provider.aws.functions: - # Define the list of functions available, each function is required to have a unique name. - # Create a function that accepts events coming from cloudwatchlogs. - - name: cloudwatch - enabled: false - type: cloudwatch_logs - - # Description of the method to help identify them when you run multiple functions. - description: "lambda function for cloudwatch logs" - - # Concurrency, is the reserved number of instances for that function. - # Default is 5. - # - # Note: There is a hard limit of 1000 functions of any kind per account. - #concurrency: 5 - - # The maximum memory allocated for this function, the configured size must be a factor of 64. - # There is a hard limit of 3008MiB for each function. Default is 128MiB. - #memory_size: 128MiB - - # The amount of time the function is allowed to run. - #timeout: 3s - - # Execution role of the function. - #role: arn:aws:iam::123456789012:role/MyFunction - - # Connect to private resources in an Amazon VPC. - #virtual_private_cloud: - # security_group_ids: [] - # subnet_ids: [] - - # Dead letter queue configuration, this must be set to an ARN pointing to an SQS queue. - #dead_letter_config.target_arn: - - # Tags are key-value pairs attached to the function. - #tags: - # department: ops - - # Optional fields that you can specify to add additional information to the - # output. Fields can be scalar values, arrays, dictionaries, or any nested - # combination of these. - #fields: - # env: staging - - # List of cloudwatch log group registered to that function. - triggers: - - log_group_name: /aws/lambda/functionbeat-cloudwatch - #filter_pattern: mylog_ - - # Define custom processors for this function. - #processors: - # - dissect: - # tokenizer: "%{key1} %{key2}" - - # Set to true to publish fields with null values in events. - #keep_null: false - - # Create a function that accepts events from SQS queues. - - name: sqs - enabled: false - type: sqs - - # Description of the method to help identify them when you run multiple functions. - description: "lambda function for SQS events" - - # Concurrency, is the reserved number of instances for that function. - # Default is 5. - # - # Note: There is a hard limit of 1000 functions of any kind per account. - #concurrency: 5 - - # The maximum memory allocated for this function, the configured size must be a factor of 64. - # There is a hard limit of 3008MiB for each function. Default is 128MiB. - #memory_size: 128MiB - - # The amount of time the function is allowed to run. - #timeout: 3s - - # Execution role of the function. - #role: arn:aws:iam::123456789012:role/MyFunction - - # Connect to private resources in an Amazon VPC. - #virtual_private_cloud: - # security_group_ids: [] - # subnet_ids: [] - - # Dead letter queue configuration, this must be set to an ARN pointing to an SQS queue. - #dead_letter_config.target_arn: - - # Tags are key-value pairs attached to the function. - #tags: - # department: ops - - # Optional fields that you can specify to add additional information to the - # output. Fields can be scalar values, arrays, dictionaries, or any nested - # combination of these. - #fields: - # env: staging - - # List of SQS queues. - triggers: - # Arn for the SQS queue. - - event_source_arn: arn:aws:sqs:us-east-1:xxxxx:myevents - - # Define custom processors for this function. - #processors: - # - decode_json_fields: - # fields: ["message"] - # process_array: false - # max_depth: 1 - # target: "" - # overwrite_keys: false - # - - # Set to true to publish fields with null values in events. - #keep_null: false - - # Create a function that accepts events from Kinesis streams. - - name: kinesis - enabled: false - type: kinesis - - # Description of the method to help identify them when you run multiple functions. - description: "lambda function for Kinesis events" - - # Concurrency, is the reserved number of instances for that function. - # Default is 5. - # - # Note: There is a hard limit of 1000 functions of any kind per account. - #concurrency: 5 - - # The maximum memory allocated for this function, the configured size must be a factor of 64. - # There is a hard limit of 3008MiB for each function. Default is 128MiB. - #memory_size: 128MiB - - # The amount of time the function is allowed to run. - #timeout: 3s - - # Execution role of the function. - #role: arn:aws:iam::123456789012:role/MyFunction - - # Connect to private resources in an Amazon VPC. - #virtual_private_cloud: - # security_group_ids: [] - # subnet_ids: [] - - # Dead letter queue configuration, this must be set to an ARN pointing to an SQS queue. - #dead_letter_config.target_arn: - - # Tags are key-value pairs attached to the function. - #tags: - # department: ops - - # Optional fields that you can specify to add additional information to the - # output. Fields can be scalar values, arrays, dictionaries, or any nested - # combination of these. - #fields: - # env: staging - - # Define custom processors for this function. - #processors: - # This example extracts the raw data from events. - # - decode_base64_field: - # field: - # from: message - # to: message - # - decompress_gzip_field: - # field: - # from: message - # to: message - # - decode_json_fields: - # fields: ["message"] - # process_array: false - # max_depth: 1 - # target: "" - # overwrite_keys: false - - # List of Kinesis streams. - triggers: - # Arn for the Kinesis stream. - - event_source_arn: arn:aws:kinesis:us-east-1:xxxxx:myevents - - # batch_size is the number of events read in a batch. - # Default is 10. - #batch_size: 100 - - # Starting position is where to start reading events from the Kinesis stream. - # Default is trim_horizon. - #starting_position: "trim_horizon" - - # parallelization_factor is the number of batches to process from each shard concurrently. - # Default is 1. - #parallelization_factor: 1 - - # Set to true to publish fields with null values in events. - #keep_null: false - - # Create a function that accepts Cloudwatch logs from Kinesis streams. - - name: cloudwatch-logs-kinesis - enabled: false - type: cloudwatch_logs_kinesis - - # Description of the method to help identify them when you run multiple functions. - description: "lambda function for Cloudwatch logs in Kinesis events" - - # Set base64_encoded if your data is base64 encoded. - #base64_encoded: false - - # Set compressed if your data is compressed with gzip. - #compressed: true - - # Concurrency, is the reserved number of instances for that function. - # Default is 5. - # - # Note: There is a hard limit of 1000 functions of any kind per account. - #concurrency: 5 - - # The maximum memory allocated for this function, the configured size must be a factor of 64. - # There is a hard limit of 3008MiB for each function. Default is 128MiB. - #memory_size: 128MiB - - # Dead letter queue configuration, this must be set to an ARN pointing to an SQS queue. - #dead_letter_config.target_arn: - - # Tags are key-value pairs attached to the function. - #tags: - # department: ops - - # The amount of time the function is allowed to run. - #timeout: 3s - - # Execution role of the function. - #role: arn:aws:iam::123456789012:role/MyFunction - - # Connect to private resources in an Amazon VPC. - #virtual_private_cloud: - # security_group_ids: [] - # subnet_ids: [] - # - # Define custom processors for this function. - #processors: - # - decode_json_fields: - # fields: ["message"] - # process_array: false - # max_depth: 1 - # target: "" - # overwrite_keys: false - - # List of Kinesis streams. - triggers: - # Arn for the Kinesis stream. - - event_source_arn: arn:aws:kinesis:us-east-1:xxxxx:myevents - - # batch_size is the number of events read in a batch. - # Default is 10. - #batch_size: 100 - - # Starting position is where to start reading events from the Kinesis stream. - # Default is trim_horizon. - #starting_position: "trim_horizon" - - # parallelization_factor is the number of batches to process from each shard concurrently. - # Default is 1. - #parallelization_factor: 1 - - # Set to true to publish fields with null values in events. - #keep_null: false diff --git a/x-pack/functionbeat/_meta/config/beat.yml.tmpl b/x-pack/functionbeat/_meta/config/beat.yml.tmpl deleted file mode 100644 index e3872794a27..00000000000 --- a/x-pack/functionbeat/_meta/config/beat.yml.tmpl +++ /dev/null @@ -1,253 +0,0 @@ -###################### Functionbeat Configuration Example ####################### - -# This file is an example configuration file highlighting only the most common -# options. The functionbeat.reference.yml file from the same directory contains all the -# supported options with more comments. You can use it as a reference. -# -# You can find the full configuration reference here: -# https://www.elastic.co/guide/en/beats/functionbeat/index.html -# - -{{header "Provider"}} -# Configure functions to run on AWS Lambda, currently, we assume that the credentials -# are present in the environment to correctly create the function when using the CLI. -# -# Configure which S3 endpoint should we use. -functionbeat.provider.aws.endpoint: "s3.amazonaws.com" -# Configure which S3 bucket we should upload the lambda artifact. -functionbeat.provider.aws.deploy_bucket: "functionbeat-deploy" - -functionbeat.provider.aws.functions: - # Define the list of functions available, each function is required to have a unique name. - # Create a function that accepts events coming from cloudwatchlogs. - - name: cloudwatch - enabled: false - type: cloudwatch_logs - - # Description of the method to help identify them when you run multiple functions. - description: "lambda function for cloudwatch logs" - - # Concurrency, is the reserved number of instances for that function. - # Default is 5. - # - # Note: There is a hard limit of 1000 functions of any kind per account. - #concurrency: 5 - - # The maximum memory allocated for this function, the configured size must be a factor of 64. - # There is a hard limit of 3008MiB for each function. Default is 128MiB. - #memory_size: 128MiB - - # Dead letter queue configuration, this must be set to an ARN pointing to an SQS queue. - #dead_letter_config.target_arn: - - # Execution role of the function. - #role: arn:aws:iam::123456789012:role/MyFunction - - # Connect to private resources in an Amazon VPC. - #virtual_private_cloud: - # security_group_ids: [] - # subnet_ids: [] - - # Optional fields that you can specify to add additional information to the - # output. Fields can be scalar values, arrays, dictionaries, or any nested - # combination of these. - #fields: - # env: staging - - # List of cloudwatch log groups registered to that function. - triggers: - - log_group_name: /aws/lambda/functionbeat-cloudwatch_logs - filter_pattern: mylog_ - - # Define custom processors for this function. - #processors: - # - dissect: - # tokenizer: "%{key1} %{key2}" - - # Create a function that accepts events from SQS queues. - - name: sqs - enabled: false - type: sqs - - # Description of the method to help identify them when you run multiple functions. - description: "lambda function for SQS events" - - # Concurrency, is the reserved number of instances for that function. - # Default is 5. - # - # Note: There is a hard limit of 1000 functions of any kind per account. - #concurrency: 5 - - # The maximum memory allocated for this function, the configured size must be a factor of 64. - # There is a hard limit of 3008MiB for each function. Default is 128MiB. - #memory_size: 128MiB - - # Dead letter queue configuration, this must be set to an ARN pointing to an SQS queue. - #dead_letter_config.target_arn: - - # Execution role of the function. - #role: arn:aws:iam::123456789012:role/MyFunction - - # Connect to private resources in an Amazon VPC. - #virtual_private_cloud: - # security_group_ids: [] - # subnet_ids: [] - - # Optional fields that you can specify to add additional information to the - # output. Fields can be scalar values, arrays, dictionaries, or any nested - # combination of these. - #fields: - # env: staging - - # List of SQS queues. - triggers: - # Arn for the SQS queue. - - event_source_arn: arn:aws:sqs:us-east-1:xxxxx:myevents - - # Define custom processors for this function. - #processors: - # - decode_json_fields: - # fields: ["message"] - # process_array: false - # max_depth: 1 - # target: "" - # overwrite_keys: false - # - - # Create a function that accepts events from Kinesis streams. - - name: kinesis - enabled: false - type: kinesis - - # Description of the method to help identify them when you run multiple functions. - description: "lambda function for Kinesis events" - - # Concurrency, is the reserved number of instances for that function. - # Default is 5. - # - # Note: There is a hard limit of 1000 functions of any kind per account. - #concurrency: 5 - - # The maximum memory allocated for this function, the configured size must be a factor of 64. - # There is a hard limit of 3008MiB for each function. Default is 128MiB. - #memory_size: 128MiB - - # Dead letter queue configuration, this must be set to an ARN pointing to an SQS queue. - #dead_letter_config.target_arn: - - # Execution role of the function. - #role: arn:aws:iam::123456789012:role/MyFunction - - # Connect to private resources in an Amazon VPC. - #virtual_private_cloud: - # security_group_ids: [] - # subnet_ids: [] - - # Optional fields that you can specify to add additional information to the - # output. Fields can be scalar values, arrays, dictionaries, or any nested - # combination of these. - #fields: - # env: staging - - # Define custom processors for this function. - #processors: - # This example extracts the raw data from events. - # - decode_base64_field: - # field: - # from: message - # to: message - # - decompress_gzip_field: - # field: - # from: message - # to: message - # - decode_json_fields: - # fields: ["message"] - # process_array: false - # max_depth: 1 - # target: "" - # overwrite_keys: false - - # List of Kinesis streams. - triggers: - # Arn for the Kinesis stream. - - event_source_arn: arn:aws:kinesis:us-east-1:xxxxx:myevents - - # batch_size is the number of events read in a batch. - # Default is 10. - #batch_size: 100 - - # Starting position is where to start reading events from the Kinesis stream. - # Default is trim_horizon. - #starting_position: "trim_horizon" - - # parallelization_factor is the number of batches to process from each shard concurrently. - # Default is 1. - #parallelization_factor: 1 - - # Create a function that accepts Cloudwatch logs from Kinesis streams. - - name: cloudwatch-logs-kinesis - enabled: false - type: cloudwatch_logs_kinesis - - # Description of the method to help identify them when you run multiple functions. - description: "lambda function for Cloudwatch logs in Kinesis events" - - # Set base64_encoded if your data is base64 encoded. - #base64_encoded: false - - # Set compressed if your data is compressed with gzip. - #compressed: true - - # Concurrency, is the reserved number of instances for that function. - # Default is 5. - # - # Note: There is a hard limit of 1000 functions of any kind per account. - #concurrency: 5 - - # The maximum memory allocated for this function, the configured size must be a factor of 64. - # There is a hard limit of 3008MiB for each function. Default is 128MiB. - #memory_size: 128MiB - - # Dead letter queue configuration, this must be set to an ARN pointing to an SQS queue. - #dead_letter_config.target_arn: - - # Execution role of the function. - #role: arn:aws:iam::123456789012:role/MyFunction - - # Connect to private resources in an Amazon VPC. - #virtual_private_cloud: - # security_group_ids: [] - # subnet_ids: [] - - # Optional fields that you can specify to add additional information to the - # output. Fields can be scalar values, arrays, dictionaries, or any nested - # combination of these. - #fields: - # env: staging - - # Define custom processors for this function. - #processors: - # - decode_json_fields: - # fields: ["message"] - # process_array: false - # max_depth: 1 - # target: "" - # overwrite_keys: false - - # List of Kinesis streams. - triggers: - # Arn for the Kinesis stream. - - event_source_arn: arn:aws:kinesis:us-east-1:xxxxx:myevents - - # batch_size is the number of events read in a batch. - # Default is 10. - #batch_size: 100 - - # Starting position is where to start reading events from the Kinesis stream. - # Default is trim_horizon. - #starting_position: "trim_horizon" - - # parallelization_factor is the number of batches to process from each shard concurrently. - # Default is 1. - #parallelization_factor: 1 - diff --git a/x-pack/functionbeat/_meta/fields.yml b/x-pack/functionbeat/_meta/fields.yml deleted file mode 100644 index a150a420e35..00000000000 --- a/x-pack/functionbeat/_meta/fields.yml +++ /dev/null @@ -1,4 +0,0 @@ -- key: functionbeat - title: Functionbeat - description: - fields: diff --git a/x-pack/functionbeat/config/config.go b/x-pack/functionbeat/config/config.go deleted file mode 100644 index 5ae52d96fd2..00000000000 --- a/x-pack/functionbeat/config/config.go +++ /dev/null @@ -1,143 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -// Config is put into a different package to prevent cyclic imports in case -// it is needed in several locations - -package config - -import ( - "fmt" - "regexp" - - "github.com/elastic/beats/v7/libbeat/cfgfile" - conf "github.com/elastic/elastic-agent-libs/config" -) - -var ( - // We're appending the function name to the role name. - // Limiting this to 30 because, we're prefixing the role name - // with "functionbeat-lambda-"(20 chars) and suffixing with - // the region, the max of which is "ap-southeast-2" (14 chars) - // Length constraints for roleName in AWS is 64 characters max per - // https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html - - functionPattern = "^[A-Za-z][A-Za-z0-9\\-]{0,30}$" - functionRE = regexp.MustCompile(functionPattern) - configOverrides = conf.MustNewConfigFrom(map[string]interface{}{ - "path.data": "/tmp", - "path.logs": "/tmp/logs", - "keystore.path": "/tmp/functionbeat.keystore", - "setup.template.enabled": true, - "queue.mem": map[string]interface{}{ - "flush.min_events": 10, - "flush.timeout": "0.01s", - }, - }) - functionLoggingOverrides = conf.MustNewConfigFrom(map[string]interface{}{ - "logging.to_stderr": true, - "logging.to_files": false, - }) - logstashOverrides = conf.MustNewConfigFrom(map[string]interface{}{ - "output.logstash.pipelining": 0, - }) - - // Overrides overrides the default configuration provided by libbeat. - Overrides = []cfgfile.ConditionalOverride{ - cfgfile.ConditionalOverride{ - Check: always, - Config: configOverrides, - }, - cfgfile.ConditionalOverride{ - Check: isLogstash, - Config: logstashOverrides, - }, - } - - functionOverride = cfgfile.ConditionalOverride{ - Check: always, - Config: functionLoggingOverrides, - } - - // FunctionOverrides contain logging settings - FunctionOverrides = append(Overrides, functionOverride) -) - -// Config default configuration for Functionbeat. -type Config struct { - Provider *conf.C `config:"provider" validate:"required"` -} - -// ProviderConfig is a generic configured used by providers. -type ProviderConfig struct { - Functions []*conf.C `config:"functions"` -} - -// FunctionConfig minimal configuration from each function. -type FunctionConfig struct { - Type string `config:"type"` - Name functionName `config:"name"` - Enabled bool `config:"enabled"` -} - -// DefaultConfig is the default configuration for Functionbeat. -var DefaultConfig = Config{} - -// DefaultFunctionConfig is the default configuration for new function. -var DefaultFunctionConfig = FunctionConfig{ - Enabled: true, -} - -var always = func(_ *conf.C) bool { - return true -} - -var isLogstash = func(cfg *conf.C) bool { - return isOutput(cfg, "logstash") -} - -func isOutput(cfg *conf.C, name string) bool { - outputCfg, err := cfg.Child("output", -1) - if err != nil { - return false - } - return outputCfg.HasField(name) -} - -type functionName string - -func (f *functionName) Unpack(s string) error { - if !functionRE.MatchString(s) { - return fmt.Errorf( - "invalid name: '%s', name must match [a-zA-Z0-9-] and be at most 30 characters", - s, - ) - } - *f = functionName(s) - return nil -} - -func (f *functionName) String() string { - return string(*f) -} - -// Validate enforces that function names are unique. -func (p *ProviderConfig) Validate() error { - names := make(map[functionName]bool) - for _, rawfn := range p.Functions { - fc := FunctionConfig{} - rawfn.Unpack(&fc) - - if !fc.Enabled { - return nil - } - - if _, found := names[fc.Name]; found { - return fmt.Errorf("function name '%s' already exist, name must be unique", fc.Name) - } - - names[fc.Name] = true - } - return nil -} diff --git a/x-pack/functionbeat/config/config_test.go b/x-pack/functionbeat/config/config_test.go deleted file mode 100644 index acede092095..00000000000 --- a/x-pack/functionbeat/config/config_test.go +++ /dev/null @@ -1,128 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -// Config is put into a different package to prevent cyclic imports in case -// it is needed in several locations - -package config - -import ( - "testing" - - "github.com/stretchr/testify/assert" - - conf "github.com/elastic/elastic-agent-libs/config" -) - -func TestNameMustBeUnique(t *testing.T) { - tests := []struct { - name string - v map[string]interface{} - err bool - }{ - { - name: "not unique names", - err: true, - v: map[string]interface{}{ - "functions": []map[string]interface{}{ - map[string]interface{}{ - "enabled": true, - "type": "cloudwatchlogs", - "name": "ok", - }, - map[string]interface{}{ - "enabled": true, - "type": "cloudwatchlogs", - "name": "ok", - }, - }, - }, - }, - { - name: "not unique names but duplicate is disabled", - err: false, - v: map[string]interface{}{ - "functions": []map[string]interface{}{ - map[string]interface{}{ - "enabled": true, - "type": "cloudwatchlogs", - "name": "ok", - }, - map[string]interface{}{ - "enabled": false, - "type": "cloudwatchlogs", - "name": "ok", - }, - }, - }, - }, - { - name: "name are uniques", - err: false, - v: map[string]interface{}{ - "functions": []map[string]interface{}{ - map[string]interface{}{ - "enabled": true, - "type": "cloudwatchlogs", - "name": "ok", - }, - map[string]interface{}{ - "enabled": true, - "type": "cloudwatchlogs", - "name": "another", - }, - }, - }, - }, - } - - for _, test := range tests { - t.Run(test.name, func(t *testing.T) { - cfg, err := conf.NewConfigFrom(test.v) - if !assert.NoError(t, err) { - return - } - provider := ProviderConfig{} - - err = cfg.Unpack(&provider) - if test.err == true { - assert.Error(t, err) - return - } - assert.NoError(t, err) - }) - } -} - -func TestFunctionName(t *testing.T) { - t.Run("valid function name", func(t *testing.T) { - f := functionName("") - err := f.Unpack("hello-world") - if !assert.NoError(t, err) { - return - } - assert.Equal(t, functionName("hello-world"), f) - }) - - t.Run("valid function name: length of 30 chars", func(t *testing.T) { - f := functionName("") - err := f.Unpack("something-which-is--30--chars") - if !assert.NoError(t, err) { - return - } - assert.Equal(t, functionName("something-which-is--30--chars"), f) - }) - - t.Run("invalid function name", func(t *testing.T) { - f := functionName("") - err := f.Unpack("hello world") - assert.Error(t, err) - }) - - t.Run("invalid function name: length", func(t *testing.T) { - f := functionName("") - err := f.Unpack("something-which-is-greater-than-thirty-characters") - assert.Error(t, err) - }) -} diff --git a/x-pack/functionbeat/conftest.py b/x-pack/functionbeat/conftest.py deleted file mode 100644 index 8e1002b41e5..00000000000 --- a/x-pack/functionbeat/conftest.py +++ /dev/null @@ -1,5 +0,0 @@ -import os -import sys - -sys.path.append(os.path.join(os.path.dirname(__file__), '../../libbeat/tests/system')) -sys.path.append(os.path.join(os.path.dirname(__file__), './tests/system')) diff --git a/x-pack/functionbeat/dev-tools/packaging/packages.yml b/x-pack/functionbeat/dev-tools/packaging/packages.yml deleted file mode 100644 index 480b31820b5..00000000000 --- a/x-pack/functionbeat/dev-tools/packaging/packages.yml +++ /dev/null @@ -1,100 +0,0 @@ ---- - -# This file contains the package specifications for Functionbeat. - -shared: - - &common - name: '{{.BeatName}}' - service_name: '{{.BeatServiceName}}' - os: '{{.GOOS}}' - arch: '{{.PackageArch}}' - vendor: '{{.BeatVendor}}' - version: '{{ beat_version }}' - license: '{{.BeatLicense}}' - url: '{{.BeatURL}}' - description: '{{.BeatDescription}}' - - - &binary_files - '{{.BeatName}}{{.BinaryExt}}': - source: build/golang-crossbuild/{{.BeatName}}-{{.GOOS}}-{{.Platform.Arch}}{{.BinaryExt}} - mode: 0755 - fields.yml: - source: fields.yml - mode: 0644 - LICENSE.txt: - source: '{{ repo.RootDir }}/LICENSE.txt' - mode: 0644 - NOTICE.txt: - source: '{{ repo.RootDir }}/NOTICE.txt' - mode: 0644 - README.md: - template: '{{ elastic_beats_dir }}/dev-tools/packaging/templates/common/README.md.tmpl' - mode: 0644 - .build_hash.txt: - content: > - {{ commit }} - mode: 0644 - '{{.BeatName}}.reference.yml': - source: '{{.BeatName}}.reference.yml' - mode: 0644 - '{{.BeatName}}.yml': - source: '{{.BeatName}}.yml' - mode: 0600 - config: true - - # Binary package spec (tar.gz for linux/darwin) - - &binary_spec - <<: *common - files: - <<: *binary_files - - # - # License modifiers for the Elastic License - # - - &elastic_license_for_binaries - license: "Elastic License" - files: - LICENSE.txt: - source: '{{ repo.RootDir }}/licenses/ELASTIC-LICENSE.txt' - mode: 0644 - # - # Binaries used to run functions. - # - - &functionbeat_binaries - files: - pkg/functionbeat-aws: - source: 'provider/aws/build/golang-crossbuild/aws-linux-amd64' - mode: 0755 - -# specs is a list of named packaging "flavors". -specs: - functionbeat: - ### - # Elastic Licensed Packages - ### - - os: windows - types: [zip] - spec: - <<: *binary_spec - <<: *functionbeat_binaries - <<: *elastic_license_for_binaries - files: - '{{.BeatName}}{{.BinaryExt}}': - source: build/golang-crossbuild/{{.BeatName}}-{{.GOOS}}-{{.Platform.Arch}}{{.BinaryExt}} - - - os: darwin - types: [tgz] - spec: - <<: *binary_spec - <<: *functionbeat_binaries - <<: *elastic_license_for_binaries - - - os: linux - types: [tgz] - spec: - <<: *binary_spec - <<: *functionbeat_binaries - <<: *elastic_license_for_binaries - files: - '{{.BeatName}}{{.BinaryExt}}': - source: build/golang-crossbuild/{{.BeatName}}-{{.GOOS}}-{{.Platform.Arch}}{{.BinaryExt}} diff --git a/x-pack/functionbeat/docker-compose.yml b/x-pack/functionbeat/docker-compose.yml deleted file mode 100644 index aa6cc364a7e..00000000000 --- a/x-pack/functionbeat/docker-compose.yml +++ /dev/null @@ -1,28 +0,0 @@ -version: '2.3' -services: - beat: - build: ${PWD}/. - depends_on: - - proxy_dep - working_dir: /go/src/github.com/elastic/beats/x-pack/functionbeat - volumes: - - ${PWD}/../..:/go/src/github.com/elastic/beats/ - # We launch docker containers to test docker autodiscover: - - /var/run/docker.sock:/var/run/docker.sock - command: make - - # This is a proxy used to block beats until all services are healthy. - # See: https://github.com/docker/compose/issues/4369 - proxy_dep: - image: busybox - depends_on: - elasticsearch: { condition: service_healthy } - - elasticsearch: - extends: - file: ${ES_BEATS}/testing/environments/${TESTING_ENVIRONMENT}.yml - service: elasticsearch - healthcheck: - test: ["CMD-SHELL", "curl -u admin:testing -s http://localhost:9200/_cat/health?h=status | grep -q green"] - retries: 300 - interval: 1s diff --git a/x-pack/functionbeat/docs/config-options-aws.asciidoc b/x-pack/functionbeat/docs/config-options-aws.asciidoc deleted file mode 100644 index 7f0328127f0..00000000000 --- a/x-pack/functionbeat/docs/config-options-aws.asciidoc +++ /dev/null @@ -1,219 +0,0 @@ -[id="configuration-{beatname_lc}-options"] -[role="xpack"] - -:libbeat-xpack-dir: ../../../x-pack/libbeat - -== Configure AWS functions - -++++ -AWS functions -++++ - -{beatname_uc} runs as a function in your serverless environment. - -Before deploying {beatname_uc}, you need to configure one or more functions and -specify details about the services that will trigger the functions. - -You configure the functions in the the +{beatname_lc}.yml+ configuration file. -When you're done, you can <> -to your serverless environment. - -The `aws` functions require AWS credentials configuration in order to make AWS API calls. -Users can either use `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` and/or -`AWS_SESSION_TOKEN`, or use shared AWS credentials file. -Please see <> for more details. - -The following example configures two functions: `cloudwatch` and `sqs`. The -`cloudwatch` function collects events from CloudWatch Logs. The `sqs` function -collects messages from Amazon Simple Queue Service (SQS). Both functions forward -the events to {es}. - -["source","sh",subs="attributes"] ----- -{beatname_lc}.provider.aws.endpoint: "s3.amazonaws.com" -{beatname_lc}.provider.aws.deploy_bucket: "functionbeat-deploy" -{beatname_lc}.provider.aws.functions: - - name: cloudwatch - enabled: true - type: cloudwatch_logs - description: "lambda function for cloudwatch logs" - triggers: - - log_group_name: /aws/lambda/my-lambda-function - #filter_pattern: mylog_ - - name: sqs - enabled: true - type: sqs - description: "lambda function for SQS events" - triggers: - - event_source_arn: arn:aws:sqs:us-east-1:123456789012:myevents - -cloud.id: "MyESDeployment:SomeLongString==" -cloud.auth: "elastic:SomeLongString" - -processors: - - add_host_metadata: ~ - - add_cloud_metadata: ~ ----- - -[id="{beatname_lc}-options"] -[float] -=== Configuration options -You can specify the following options to configure the functions that you want -to deploy. - -TIP: If you change the configuration after deploying the function, use -the <> to update your deployment. - -[float] -[id="{beatname_lc}-deploy-bucket"] -==== `provider.aws.deploy_bucket` - -A unique name for the S3 bucket that the Lambda artifact will be uploaded to. - -[float] -[id="{beatname_lc}-name"] -==== `name` - -A unique name for the Lambda function. This is the name of the function as it -will appear in the Lambda console on AWS. - -[float] -[id="{beatname_lc}-type"] -==== `type` - -The type of service to monitor. For this release, the supported types -are: - -[horizontal] -`cloudwatch_logs`:: Collects events from CloudWatch logs. -`sqs`:: Collects data from Amazon Simple Queue Service (SQS). -`kinesis`:: Collects data from a Kinesis stream. - -[float] -[id="{beatname_lc}-description"] -==== `description` - -A description of the function. This description is useful when you are running -multiple functions and need more context about how each function is used. - -[float] -[id="{beatname_lc}-triggers"] -==== `triggers` - -A list of triggers that will cause the function to execute. The list of valid -triggers depends on the `type`: - -* For `cloudwatch_logs`, specify a list of log groups. Because the AWS limit is -one subscription filter per CloudWatch log group, the log groups specified here -must have no other subscription filters, or deployment will fail. -For more information, see <>. -* For `sqs` or `kinesis`, specify a list of Amazon Resource Names (ARNs). - -[float] -[id="{beatname_lc}-filter_pattern"] -==== `filter_pattern` - -A regular expression that matches the events you want to collect. Setting this -option may reduce execution costs because the function only executes if there is -data that matches the pattern. - -[float] -[id="{beatname_lc}-concurrency"] -==== `concurrency` - -The reserved number of instances for the function. Setting this option may -reduce execution costs by limiting the number of functions that can execute in -your serverless environment. The default is unreserved. - -[float] -[id="{beatname_lc}-memory-size"] -==== `memory_size` - -The maximum amount of memory to allocate for this function. Specify a value that -is a factor of 64. There is a hard limit of 3008 MiB for each function. The -default is 128 MiB. - -[float] -[id="{beatname_lc}-role"] -==== `role` - -The custom execution role to use for the deployed function. For example: - -[source,yaml] ----- - role: arn:aws:iam::123456789012:role/MyFunction ----- - -Make sure the custom role has the permissions required to run the function. For -more information, see <>. - -If `role` is not specified, the function uses the default role and policy -created during deployment. - -[float] -[id="{beatname_lc}-virtual_private_cloud"] -==== `virtual_private_cloud` - -Specifies additional settings required to connect to private resources in an -Amazon Virtual Private Cloud (VPC). For example: - -[source,yaml] ----- - virtual_private_cloud: - security_group_ids: - - mySecurityGroup - - anotherSecurityGroup - subnet_ids: - - myUniqueID ----- - -[float] -[id="{beatname_lc}-dead-letter-config"] -==== `dead_letter_config.target_arn` - -The dead letter queue to use for messages that can't be processed successfully. -Set this option to an ARN that points to an SQS queue. - -[float] -[id="{beatname_lc}-batch-size"] -==== `batch_size` - -The number of events to read from a Kinesis stream, the minimum value is 100 and the maximum is -10000. The default is 100. - -[float] -[id="{beatname_lc}-starting-position"] -==== `starting_position` - -The starting position to read from a Kinesis stream, valids values are `trim_horizon` and `latest`. -The default is trim_horizon. - -[float] -[id="{beatname_lc}-parallelization-factor"] -==== `parallelization_factor` - -The number of batches to process from each shard concurrently, the minimum value is 1 and the maximum is 10 -The default is 1. - -[float] -[id="{beatname_lc}-keep-null"] -==== `keep_null` - -If this option is set to true, fields with `null` values will be published in -the output document. By default, `keep_null` is set to `false`. - -[float] -[id="{beatname_lc}-index"] -==== `index` - -If present, this formatted string overrides the index for events from this function -(for elasticsearch outputs), or sets the `raw_index` field of the event's -metadata (for other outputs). This string can only refer to the agent name and -version and the event timestamp; for access to dynamic fields, use -`output.elasticsearch.index` or a processor. - -Example value: `"%{[agent.name]}-myindex-%{+yyyy.MM.dd}"` might -expand to `"functionbeat-myindex-2019.12.13"`. - -[id="aws-credentials-config"] -include::{libbeat-xpack-dir}/docs/aws-credentials-config.asciidoc[] diff --git a/x-pack/functionbeat/docs/configuring-howto.asciidoc b/x-pack/functionbeat/docs/configuring-howto.asciidoc deleted file mode 100644 index fad0629261b..00000000000 --- a/x-pack/functionbeat/docs/configuring-howto.asciidoc +++ /dev/null @@ -1,66 +0,0 @@ -[id="configuring-howto-{beatname_lc}"] -[role="xpack"] -= Configure {beatname_uc} - -[partintro] --- -++++ -Configure -++++ - -include::{libbeat-dir}/shared/configuring-intro.asciidoc[] - -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <<{beatname_lc}-reference-yml>> - --- - -include::./config-options-aws.asciidoc[] - -include::./general-options.asciidoc[] - -[role="xpack"] -include::{libbeat-dir}/outputconfig.asciidoc[] - -ifndef::no_kerberos[] -include::{libbeat-dir}/shared-kerberos-config.asciidoc[] -endif::[] - -[role="xpack"] -include::{libbeat-dir}/shared-ssl-config.asciidoc[] - -[role="xpack"] -include::{libbeat-dir}/shared-ilm.asciidoc[] - -[role="xpack"] -include::{libbeat-dir}/setup-config.asciidoc[] - -[role="xpack"] -include::./filtering.asciidoc[] - -:allplatforms: -[role="xpack"] -include::{libbeat-dir}/queueconfig.asciidoc[] -:allplatforms!: - -[role="xpack"] -include::{libbeat-dir}/loggingconfig.asciidoc[] - -[role="xpack"] -include::{libbeat-dir}/regexp.asciidoc[] - -[role="xpack"] -include::{libbeat-dir}/shared-instrumentation.asciidoc[] - -[role="xpack"] -include::{libbeat-dir}/reference-yml.asciidoc[] diff --git a/x-pack/functionbeat/docs/deploying.asciidoc b/x-pack/functionbeat/docs/deploying.asciidoc deleted file mode 100644 index 5cfe9d98982..00000000000 --- a/x-pack/functionbeat/docs/deploying.asciidoc +++ /dev/null @@ -1,113 +0,0 @@ -[id="deploy-to-cloud-provider"] -[role="xpack"] -=== Deploy {beatname_uc} to your cloud provider - -After configuring {beatname_uc} and defining cloud functions for the services -you want to monitor, deploy the functions to your cloud provider. To do this, -you can use the {beatname_uc} manager (good for getting started), or use your -own deployment infrastructure. - -[[manager-deployment]] -==== Use the {beatname_uc} manager - -Use the built-in manager to deploy, update, or delete {beatname_uc} functions -when you don't have your own deployment infrastructure or process in place. - -During deployment, the {beatname_uc} manager: - -* Exports a function template to use for deployment. For AWS, it exports an -{cloudformation-ref} template. To inspect the template, run the -<> command. -* Creates a zip package that includes the function code and +{beatname_lc}.yml+ -config file. -* Uploads the package to the specified cloud provider. - -See <<{beatname_lc}-deploying>> in the getting started to learn how to deploy -functions by using the {beatname_uc} manager. - -[[own-deployment]] -==== Use your own deployment infrastructure - -If you don't want to use the {beatname_uc} manager, use your own deployment -infrastructure. To do this, create a package, then deploy it to your cloud -provider: - -. Set the following environment variables: -+ -`BEAT_STRICT_PERMS=false`:: This setting makes the function skip the ownership -check on the configuration file. -`ENABLED_FUNCTIONS=function-name-1,function-name-2`:: Specifies a -comma-separated list of functions that are enabled in the configuration file. For -example, to package functions called `my-kinesis` and `my-cloudwatch-logs`, run: -+ -*linux and mac*: -+ -[source, shell] ----- -export BEAT_STRICT_PERMS=false -export ENABLED_FUNCTIONS=my-kinesis,my-cloudwatch-logs ----- -+ -*win*: -+ -[source, shell] ----- -set BEAT_STRICT_PERMS=false -set ENABLED_FUNCTIONS=my-kinesis,my-cloudwatch-logs ----- -+ -TIP: For easier management, we recommend having one Lambda per function. - -. Run the `package` command to package the functions and dependencies into an -archive. For example: -+ -*linux and mac:* -+ -["source","sh",subs="attributes"] ----------------------------------------------------------------------- -./{beatname_lc} -v -e -d "*" package --output /path/to/folder/package-{{.Provider}}.zip ----------------------------------------------------------------------- -+ -*win:* -+ -["source","sh",subs="attributes"] ----------------------------------------------------------------------- -.{backslash}{beatname_lc}.exe -v -e -d "*" package --output /path/to/folder/package-{{.Provider}}.zip ----------------------------------------------------------------------- -+ -For `--output` specify a full path pattern. -+ -The `package` command generates deployment packages for each provider specified -in the configuration. Each package contains: -+ -* a binary with the function code -* the `functionbeat.yml` config file - -. If certificates are required, add the cert files to the zip package under the -same path as the configured +{beatname_lc}.yml+ file. - -. Export a function template to use for deployment: -+ -*linux and mac:* -+ -["source","sh",subs="attributes"] ----------------------------------------------------------------------- -./{beatname_lc} export function FUNCTION_NAME ----------------------------------------------------------------------- -+ -*win:* -+ -["source","sh",subs="attributes"] ----------------------------------------------------------------------- -.{backslash}{beatname_lc}.exe export function FUNCTION_NAME ----------------------------------------------------------------------- -+ -{beatname_uc} writes the template to stdout. For AWS functions, it writes an -{cloudformation-ref} template. - -. Modify the template to work with your infrastructure. - -. Deploy the package, using the infrastructure and automation supported by your -cloud provider, for example, {cloudformation-ref}. -+ -For more information about deployment, see your cloud provider's documentation. diff --git a/x-pack/functionbeat/docs/export-cloudformation-template.asciidoc b/x-pack/functionbeat/docs/export-cloudformation-template.asciidoc deleted file mode 100644 index 803ab5a6f8b..00000000000 --- a/x-pack/functionbeat/docs/export-cloudformation-template.asciidoc +++ /dev/null @@ -1,27 +0,0 @@ -[[export-cloudformation-template]] -[role="xpack"] -=== Export AWS CloudFormation template - -You can use {beatname_uc} to export an {cloudformation-ref} template then use -the template with automation software to deploy {beatname_uc} code to your cloud -environment. - -After configuring {beatname_uc}, use the following command to export the -CloudFormation template: - -*linux and mac:* - -["source","sh",subs="attributes"] ----------------------------------------------------------------------- -./{beatname_lc} export function FUNCTION_NAME ----------------------------------------------------------------------- - -*win:* - -["source","sh",subs="attributes"] ----------------------------------------------------------------------- -.{backslash}{beatname_lc}.exe export function FUNCTION_NAME ----------------------------------------------------------------------- - -{beatname_uc} writes the CloudFormation template to stdout. Modify the template -to work with your infrastructure. diff --git a/x-pack/functionbeat/docs/faq-resource-limit.asciidoc b/x-pack/functionbeat/docs/faq-resource-limit.asciidoc deleted file mode 100644 index c4db5a4c683..00000000000 --- a/x-pack/functionbeat/docs/faq-resource-limit.asciidoc +++ /dev/null @@ -1,55 +0,0 @@ -[[unable-to-deploy-resource-limit]] -=== Deployment to AWS fails with "resource limit exceeded" - -Deployment fails with the following message if you attempt to deploy a Lambda -function that reads from a CloudWatch log group that already has a subscription -filter defined on it: - -[source,shell] ----- -CREATE_FAILED, ResourceStatusReason: Resource limit exceeded ----- - -The AWS limit on subscription filters is one per log group. If you've already -deployed a Lambda function that monitors the log group, even if you deleted the -function, the filter subscription might still exist. - -To resolve this issue, use the AWS logs -https://docs.aws.amazon.com/cli/latest/reference/logs/describe-subscription-filters.html[`describe-subscription-filters`] -command on the log group. For example, if you're using the AWS CLI, run: - -[source,shell] ----- -aws logs describe-subscription-filters --log-group-name /aws/lambda/hello-world-python ----- - -The output will look something like: - -[source,json] ----- -{ - "subscriptionFilters": [ - { - "filterPattern": "", - "filterName": "fnb-cloudwatch-stack-fnbcloudwatch3SFawslambdahelloworldpython-11WH0BC1BM1NP", - "creationTime": 1565194872642, - "logGroupName": "/aws/lambda/hello-world-python", - "destinationArn": "arn:aws:lambda:us-east-2:551009506772:function:cloudwatch", - "distribution": "ByLogStream" - } - ] -} ----- - -If you're no longer using the subscription filter, you can use the AWS logs -https://docs.aws.amazon.com/cli/latest/reference/logs/delete-subscription-filter.html[`delete-subscription-filter`] -command to delete it. For example: - -[source,shell] ----- -aws logs delete-subscription-filter --log-group-name /aws/lambda/hello-world-python --filter-name fnb-cloudwatch-stack-fnbcloudwatch3SFawslambdahelloworldpython-11WH0BC1BM1NP ----- - -Before attempting to redeploy the function, you might need to go to the -CloudFormation console in AWS and delete the stack that {beatname_uc} -created for the failed deployment. diff --git a/x-pack/functionbeat/docs/faq.asciidoc b/x-pack/functionbeat/docs/faq.asciidoc deleted file mode 100644 index 6e942b9633c..00000000000 --- a/x-pack/functionbeat/docs/faq.asciidoc +++ /dev/null @@ -1,23 +0,0 @@ -[[faq]] -[role="xpack"] -== Common problems - -This section describes common problems you might encounter with -{beatname_uc}. Also check out the -https://discuss.elastic.co/c/beats/{beatname_lc}[{beatname_uc} discussion forum]. - -[[unable-to-deploy]] -=== Deployment to AWS fails with "failed to create the stack" - -Deployment fails if you attempt to deploy the Lambda function to the wrong -region. - -You must deploy the function to the region where your services are running. For -example, if you want to monitor CloudWatch logs for a service running in the -`us-east-1` region, you must deploy the Lambda function to the same region, or -deployment fails. - -include::faq-resource-limit.asciidoc[] - -include::{libbeat-dir}/shared-faq.asciidoc[] - diff --git a/x-pack/functionbeat/docs/fields.asciidoc b/x-pack/functionbeat/docs/fields.asciidoc deleted file mode 100644 index 08589bd0299..00000000000 --- a/x-pack/functionbeat/docs/fields.asciidoc +++ /dev/null @@ -1,15676 +0,0 @@ - -//// -This file is generated! See _meta/fields.yml and scripts/generate_fields_docs.py -//// - -:edit_url: - -[[exported-fields]] -= Exported fields - -[partintro] - --- -This document describes the fields that are exported by Functionbeat. They are -grouped in the following categories: - -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> -* <> - --- -[[exported-fields-beat-common]] -== Beat fields - -Contains common beat fields available in all event types. - - - -*`agent.hostname`*:: -+ --- -Deprecated - use agent.name or agent.id to identify an agent. - - -type: alias - -alias to: agent.name - --- - -*`beat.timezone`*:: -+ --- -type: alias - -alias to: event.timezone - --- - -*`fields`*:: -+ --- -Contains user configurable fields. - - -type: object - --- - -*`beat.name`*:: -+ --- -type: alias - -alias to: host.name - --- - -*`beat.hostname`*:: -+ --- -type: alias - -alias to: agent.name - --- - -*`timeseries.instance`*:: -+ --- -Time series instance id - -type: keyword - --- - -[[exported-fields-cloud]] -== Cloud provider metadata fields - -Metadata from cloud providers added by the add_cloud_metadata processor. - - - -*`cloud.image.id`*:: -+ --- -Image ID for the cloud instance. - - -example: ami-abcd1234 - --- - -*`meta.cloud.provider`*:: -+ --- -type: alias - -alias to: cloud.provider - --- - -*`meta.cloud.instance_id`*:: -+ --- -type: alias - -alias to: cloud.instance.id - --- - -*`meta.cloud.instance_name`*:: -+ --- -type: alias - -alias to: cloud.instance.name - --- - -*`meta.cloud.machine_type`*:: -+ --- -type: alias - -alias to: cloud.machine.type - --- - -*`meta.cloud.availability_zone`*:: -+ --- -type: alias - -alias to: cloud.availability_zone - --- - -*`meta.cloud.project_id`*:: -+ --- -type: alias - -alias to: cloud.project.id - --- - -*`meta.cloud.region`*:: -+ --- -type: alias - -alias to: cloud.region - --- - -[[exported-fields-docker-processor]] -== Docker fields - -Docker stats collected from Docker. - - - - -*`docker.container.id`*:: -+ --- -type: alias - -alias to: container.id - --- - -*`docker.container.image`*:: -+ --- -type: alias - -alias to: container.image.name - --- - -*`docker.container.name`*:: -+ --- -type: alias - -alias to: container.name - --- - -*`docker.container.labels`*:: -+ --- -Image labels. - - -type: object - --- - -[[exported-fields-ecs]] -== ECS fields - - -This section defines Elastic Common Schema (ECS) fields—a common set of fields -to be used when storing event data in {es}. - -This is an exhaustive list, and fields listed here are not necessarily used by {beatname_uc}. -The goal of ECS is to enable and encourage users of {es} to normalize their event data, -so that they can better analyze, visualize, and correlate the data represented in their events. - -See the {ecs-ref}[ECS reference] for more information. - -*`@timestamp`*:: -+ --- -Date/time when the event originated. -This is the date/time extracted from the event, typically representing when the event was generated by the source. -If the event source has no original timestamp, this value is typically populated by the first time the event was received by the pipeline. -Required field for all events. - -type: date - -example: 2016-05-23T08:05:34.853Z - -required: True - --- - -*`labels`*:: -+ --- -Custom key/value pairs. -Can be used to add meta information to events. Should not contain nested objects. All values are stored as keyword. -Example: `docker` and `k8s` labels. - -type: object - -example: {"application": "foo-bar", "env": "production"} - --- - -*`message`*:: -+ --- -For log events the message field contains the log message, optimized for viewing in a log viewer. -For structured logs without an original message field, other fields can be concatenated to form a human-readable summary of the event. -If multiple messages exist, they can be combined into one message. - -type: match_only_text - -example: Hello World - --- - -*`tags`*:: -+ --- -List of keywords used to tag each event. - -type: keyword - -example: ["production", "env2"] - --- - -[float] -=== agent - -The agent fields contain the data about the software entity, if any, that collects, detects, or observes events on a host, or takes measurements on a host. -Examples include Beats. Agents may also run on observers. ECS agent.* fields shall be populated with details of the agent running on the host or observer where the event happened or the measurement was taken. - - -*`agent.build.original`*:: -+ --- -Extended build information for the agent. -This field is intended to contain any build information that a data source may provide, no specific formatting is required. - -type: keyword - -example: metricbeat version 7.6.0 (amd64), libbeat 7.6.0 [6a23e8f8f30f5001ba344e4e54d8d9cb82cb107c built 2020-02-05 23:10:10 +0000 UTC] - --- - -*`agent.ephemeral_id`*:: -+ --- -Ephemeral identifier of this agent (if one exists). -This id normally changes across restarts, but `agent.id` does not. - -type: keyword - -example: 8a4f500f - --- - -*`agent.id`*:: -+ --- -Unique identifier of this agent (if one exists). -Example: For Beats this would be beat.id. - -type: keyword - -example: 8a4f500d - --- - -*`agent.name`*:: -+ --- -Custom name of the agent. -This is a name that can be given to an agent. This can be helpful if for example two Filebeat instances are running on the same host but a human readable separation is needed on which Filebeat instance data is coming from. -If no name is given, the name is often left empty. - -type: keyword - -example: foo - --- - -*`agent.type`*:: -+ --- -Type of the agent. -The agent type always stays the same and should be given by the agent used. In case of Filebeat the agent would always be Filebeat also if two Filebeat instances are run on the same machine. - -type: keyword - -example: filebeat - --- - -*`agent.version`*:: -+ --- -Version of the agent. - -type: keyword - -example: 6.0.0-rc2 - --- - -[float] -=== as - -An autonomous system (AS) is a collection of connected Internet Protocol (IP) routing prefixes under the control of one or more network operators on behalf of a single administrative entity or domain that presents a common, clearly defined routing policy to the internet. - - -*`as.number`*:: -+ --- -Unique number allocated to the autonomous system. The autonomous system number (ASN) uniquely identifies each network on the Internet. - -type: long - -example: 15169 - --- - -*`as.organization.name`*:: -+ --- -Organization name. - -type: keyword - -example: Google LLC - --- - -*`as.organization.name.text`*:: -+ --- -type: match_only_text - --- - -[float] -=== client - -A client is defined as the initiator of a network connection for events regarding sessions, connections, or bidirectional flow records. -For TCP events, the client is the initiator of the TCP connection that sends the SYN packet(s). For other protocols, the client is generally the initiator or requestor in the network transaction. Some systems use the term "originator" to refer the client in TCP connections. The client fields describe details about the system acting as the client in the network event. Client fields are usually populated in conjunction with server fields. Client fields are generally not populated for packet-level events. -Client / server representations can add semantic context to an exchange, which is helpful to visualize the data in certain situations. If your context falls in that category, you should still ensure that source and destination are filled appropriately. - - -*`client.address`*:: -+ --- -Some event client addresses are defined ambiguously. The event will sometimes list an IP, a domain or a unix socket. You should always store the raw address in the `.address` field. -Then it should be duplicated to `.ip` or `.domain`, depending on which one it is. - -type: keyword - --- - -*`client.as.number`*:: -+ --- -Unique number allocated to the autonomous system. The autonomous system number (ASN) uniquely identifies each network on the Internet. - -type: long - -example: 15169 - --- - -*`client.as.organization.name`*:: -+ --- -Organization name. - -type: keyword - -example: Google LLC - --- - -*`client.as.organization.name.text`*:: -+ --- -type: match_only_text - --- - -*`client.bytes`*:: -+ --- -Bytes sent from the client to the server. - -type: long - -example: 184 - -format: bytes - --- - -*`client.domain`*:: -+ --- -The domain name of the client system. -This value may be a host name, a fully qualified domain name, or another host naming format. The value may derive from the original event or be added from enrichment. - -type: keyword - -example: foo.example.com - --- - -*`client.geo.city_name`*:: -+ --- -City name. - -type: keyword - -example: Montreal - --- - -*`client.geo.continent_code`*:: -+ --- -Two-letter code representing continent's name. - -type: keyword - -example: NA - --- - -*`client.geo.continent_name`*:: -+ --- -Name of the continent. - -type: keyword - -example: North America - --- - -*`client.geo.country_iso_code`*:: -+ --- -Country ISO code. - -type: keyword - -example: CA - --- - -*`client.geo.country_name`*:: -+ --- -Country name. - -type: keyword - -example: Canada - --- - -*`client.geo.location`*:: -+ --- -Longitude and latitude. - -type: geo_point - -example: { "lon": -73.614830, "lat": 45.505918 } - --- - -*`client.geo.name`*:: -+ --- -User-defined description of a location, at the level of granularity they care about. -Could be the name of their data centers, the floor number, if this describes a local physical entity, city names. -Not typically used in automated geolocation. - -type: keyword - -example: boston-dc - --- - -*`client.geo.postal_code`*:: -+ --- -Postal code associated with the location. -Values appropriate for this field may also be known as a postcode or ZIP code and will vary widely from country to country. - -type: keyword - -example: 94040 - --- - -*`client.geo.region_iso_code`*:: -+ --- -Region ISO code. - -type: keyword - -example: CA-QC - --- - -*`client.geo.region_name`*:: -+ --- -Region name. - -type: keyword - -example: Quebec - --- - -*`client.geo.timezone`*:: -+ --- -The time zone of the location, such as IANA time zone name. - -type: keyword - -example: America/Argentina/Buenos_Aires - --- - -*`client.ip`*:: -+ --- -IP address of the client (IPv4 or IPv6). - -type: ip - --- - -*`client.mac`*:: -+ --- -MAC address of the client. -The notation format from RFC 7042 is suggested: Each octet (that is, 8-bit byte) is represented by two [uppercase] hexadecimal digits giving the value of the octet as an unsigned integer. Successive octets are separated by a hyphen. - -type: keyword - -example: 00-00-5E-00-53-23 - --- - -*`client.nat.ip`*:: -+ --- -Translated IP of source based NAT sessions (e.g. internal client to internet). -Typically connections traversing load balancers, firewalls, or routers. - -type: ip - --- - -*`client.nat.port`*:: -+ --- -Translated port of source based NAT sessions (e.g. internal client to internet). -Typically connections traversing load balancers, firewalls, or routers. - -type: long - -format: string - --- - -*`client.packets`*:: -+ --- -Packets sent from the client to the server. - -type: long - -example: 12 - --- - -*`client.port`*:: -+ --- -Port of the client. - -type: long - -format: string - --- - -*`client.registered_domain`*:: -+ --- -The highest registered client domain, stripped of the subdomain. -For example, the registered domain for "foo.example.com" is "example.com". -This value can be determined precisely with a list like the public suffix list (http://publicsuffix.org). Trying to approximate this by simply taking the last two labels will not work well for TLDs such as "co.uk". - -type: keyword - -example: example.com - --- - -*`client.subdomain`*:: -+ --- -The subdomain portion of a fully qualified domain name includes all of the names except the host name under the registered_domain. In a partially qualified domain, or if the the qualification level of the full name cannot be determined, subdomain contains all of the names below the registered domain. -For example the subdomain portion of "www.east.mydomain.co.uk" is "east". If the domain has multiple levels of subdomain, such as "sub2.sub1.example.com", the subdomain field should contain "sub2.sub1", with no trailing period. - -type: keyword - -example: east - --- - -*`client.top_level_domain`*:: -+ --- -The effective top level domain (eTLD), also known as the domain suffix, is the last part of the domain name. For example, the top level domain for example.com is "com". -This value can be determined precisely with a list like the public suffix list (http://publicsuffix.org). Trying to approximate this by simply taking the last label will not work well for effective TLDs such as "co.uk". - -type: keyword - -example: co.uk - --- - -*`client.user.domain`*:: -+ --- -Name of the directory the user is a member of. -For example, an LDAP or Active Directory domain name. - -type: keyword - --- - -*`client.user.email`*:: -+ --- -User email address. - -type: keyword - --- - -*`client.user.full_name`*:: -+ --- -User's full name, if available. - -type: keyword - -example: Albert Einstein - --- - -*`client.user.full_name.text`*:: -+ --- -type: match_only_text - --- - -*`client.user.group.domain`*:: -+ --- -Name of the directory the group is a member of. -For example, an LDAP or Active Directory domain name. - -type: keyword - --- - -*`client.user.group.id`*:: -+ --- -Unique identifier for the group on the system/platform. - -type: keyword - --- - -*`client.user.group.name`*:: -+ --- -Name of the group. - -type: keyword - --- - -*`client.user.hash`*:: -+ --- -Unique user hash to correlate information for a user in anonymized form. -Useful if `user.id` or `user.name` contain confidential information and cannot be used. - -type: keyword - --- - -*`client.user.id`*:: -+ --- -Unique identifier of the user. - -type: keyword - -example: S-1-5-21-202424912787-2692429404-2351956786-1000 - --- - -*`client.user.name`*:: -+ --- -Short name or login of the user. - -type: keyword - -example: a.einstein - --- - -*`client.user.name.text`*:: -+ --- -type: match_only_text - --- - -*`client.user.roles`*:: -+ --- -Array of user roles at the time of the event. - -type: keyword - -example: ["kibana_admin", "reporting_user"] - --- - -[float] -=== cloud - -Fields related to the cloud or infrastructure the events are coming from. - - -*`cloud.account.id`*:: -+ --- -The cloud account or organization id used to identify different entities in a multi-tenant environment. -Examples: AWS account id, Google Cloud ORG Id, or other unique identifier. - -type: keyword - -example: 666777888999 - --- - -*`cloud.account.name`*:: -+ --- -The cloud account name or alias used to identify different entities in a multi-tenant environment. -Examples: AWS account name, Google Cloud ORG display name. - -type: keyword - -example: elastic-dev - --- - -*`cloud.availability_zone`*:: -+ --- -Availability zone in which this host, resource, or service is located. - -type: keyword - -example: us-east-1c - --- - -*`cloud.instance.id`*:: -+ --- -Instance ID of the host machine. - -type: keyword - -example: i-1234567890abcdef0 - --- - -*`cloud.instance.name`*:: -+ --- -Instance name of the host machine. - -type: keyword - --- - -*`cloud.machine.type`*:: -+ --- -Machine type of the host machine. - -type: keyword - -example: t2.medium - --- - -*`cloud.origin.account.id`*:: -+ --- -The cloud account or organization id used to identify different entities in a multi-tenant environment. -Examples: AWS account id, Google Cloud ORG Id, or other unique identifier. - -type: keyword - -example: 666777888999 - --- - -*`cloud.origin.account.name`*:: -+ --- -The cloud account name or alias used to identify different entities in a multi-tenant environment. -Examples: AWS account name, Google Cloud ORG display name. - -type: keyword - -example: elastic-dev - --- - -*`cloud.origin.availability_zone`*:: -+ --- -Availability zone in which this host, resource, or service is located. - -type: keyword - -example: us-east-1c - --- - -*`cloud.origin.instance.id`*:: -+ --- -Instance ID of the host machine. - -type: keyword - -example: i-1234567890abcdef0 - --- - -*`cloud.origin.instance.name`*:: -+ --- -Instance name of the host machine. - -type: keyword - --- - -*`cloud.origin.machine.type`*:: -+ --- -Machine type of the host machine. - -type: keyword - -example: t2.medium - --- - -*`cloud.origin.project.id`*:: -+ --- -The cloud project identifier. -Examples: Google Cloud Project id, Azure Project id. - -type: keyword - -example: my-project - --- - -*`cloud.origin.project.name`*:: -+ --- -The cloud project name. -Examples: Google Cloud Project name, Azure Project name. - -type: keyword - -example: my project - --- - -*`cloud.origin.provider`*:: -+ --- -Name of the cloud provider. Example values are aws, azure, gcp, or digitalocean. - -type: keyword - -example: aws - --- - -*`cloud.origin.region`*:: -+ --- -Region in which this host, resource, or service is located. - -type: keyword - -example: us-east-1 - --- - -*`cloud.origin.service.name`*:: -+ --- -The cloud service name is intended to distinguish services running on different platforms within a provider, eg AWS EC2 vs Lambda, GCP GCE vs App Engine, Azure VM vs App Server. -Examples: app engine, app service, cloud run, fargate, lambda. - -type: keyword - -example: lambda - --- - -*`cloud.project.id`*:: -+ --- -The cloud project identifier. -Examples: Google Cloud Project id, Azure Project id. - -type: keyword - -example: my-project - --- - -*`cloud.project.name`*:: -+ --- -The cloud project name. -Examples: Google Cloud Project name, Azure Project name. - -type: keyword - -example: my project - --- - -*`cloud.provider`*:: -+ --- -Name of the cloud provider. Example values are aws, azure, gcp, or digitalocean. - -type: keyword - -example: aws - --- - -*`cloud.region`*:: -+ --- -Region in which this host, resource, or service is located. - -type: keyword - -example: us-east-1 - --- - -*`cloud.service.name`*:: -+ --- -The cloud service name is intended to distinguish services running on different platforms within a provider, eg AWS EC2 vs Lambda, GCP GCE vs App Engine, Azure VM vs App Server. -Examples: app engine, app service, cloud run, fargate, lambda. - -type: keyword - -example: lambda - --- - -*`cloud.target.account.id`*:: -+ --- -The cloud account or organization id used to identify different entities in a multi-tenant environment. -Examples: AWS account id, Google Cloud ORG Id, or other unique identifier. - -type: keyword - -example: 666777888999 - --- - -*`cloud.target.account.name`*:: -+ --- -The cloud account name or alias used to identify different entities in a multi-tenant environment. -Examples: AWS account name, Google Cloud ORG display name. - -type: keyword - -example: elastic-dev - --- - -*`cloud.target.availability_zone`*:: -+ --- -Availability zone in which this host, resource, or service is located. - -type: keyword - -example: us-east-1c - --- - -*`cloud.target.instance.id`*:: -+ --- -Instance ID of the host machine. - -type: keyword - -example: i-1234567890abcdef0 - --- - -*`cloud.target.instance.name`*:: -+ --- -Instance name of the host machine. - -type: keyword - --- - -*`cloud.target.machine.type`*:: -+ --- -Machine type of the host machine. - -type: keyword - -example: t2.medium - --- - -*`cloud.target.project.id`*:: -+ --- -The cloud project identifier. -Examples: Google Cloud Project id, Azure Project id. - -type: keyword - -example: my-project - --- - -*`cloud.target.project.name`*:: -+ --- -The cloud project name. -Examples: Google Cloud Project name, Azure Project name. - -type: keyword - -example: my project - --- - -*`cloud.target.provider`*:: -+ --- -Name of the cloud provider. Example values are aws, azure, gcp, or digitalocean. - -type: keyword - -example: aws - --- - -*`cloud.target.region`*:: -+ --- -Region in which this host, resource, or service is located. - -type: keyword - -example: us-east-1 - --- - -*`cloud.target.service.name`*:: -+ --- -The cloud service name is intended to distinguish services running on different platforms within a provider, eg AWS EC2 vs Lambda, GCP GCE vs App Engine, Azure VM vs App Server. -Examples: app engine, app service, cloud run, fargate, lambda. - -type: keyword - -example: lambda - --- - -[float] -=== code_signature - -These fields contain information about binary code signatures. - - -*`code_signature.digest_algorithm`*:: -+ --- -The hashing algorithm used to sign the process. -This value can distinguish signatures when a file is signed multiple times by the same signer but with a different digest algorithm. - -type: keyword - -example: sha256 - --- - -*`code_signature.exists`*:: -+ --- -Boolean to capture if a signature is present. - -type: boolean - -example: true - --- - -*`code_signature.signing_id`*:: -+ --- -The identifier used to sign the process. -This is used to identify the application manufactured by a software vendor. The field is relevant to Apple *OS only. - -type: keyword - -example: com.apple.xpc.proxy - --- - -*`code_signature.status`*:: -+ --- -Additional information about the certificate status. -This is useful for logging cryptographic errors with the certificate validity or trust status. Leave unpopulated if the validity or trust of the certificate was unchecked. - -type: keyword - -example: ERROR_UNTRUSTED_ROOT - --- - -*`code_signature.subject_name`*:: -+ --- -Subject name of the code signer - -type: keyword - -example: Microsoft Corporation - --- - -*`code_signature.team_id`*:: -+ --- -The team identifier used to sign the process. -This is used to identify the team or vendor of a software product. The field is relevant to Apple *OS only. - -type: keyword - -example: EQHXZ8M8AV - --- - -*`code_signature.timestamp`*:: -+ --- -Date and time when the code signature was generated and signed. - -type: date - -example: 2021-01-01T12:10:30Z - --- - -*`code_signature.trusted`*:: -+ --- -Stores the trust status of the certificate chain. -Validating the trust of the certificate chain may be complicated, and this field should only be populated by tools that actively check the status. - -type: boolean - -example: true - --- - -*`code_signature.valid`*:: -+ --- -Boolean to capture if the digital signature is verified against the binary content. -Leave unpopulated if a certificate was unchecked. - -type: boolean - -example: true - --- - -[float] -=== container - -Container fields are used for meta information about the specific container that is the source of information. These fields help correlate data based containers from any runtime. - - -*`container.cpu.usage`*:: -+ --- -Percent CPU used which is normalized by the number of CPU cores and it ranges from 0 to 1. Scaling factor: 1000. - -type: scaled_float - --- - -*`container.disk.read.bytes`*:: -+ --- -The total number of bytes (gauge) read successfully (aggregated from all disks) since the last metric collection. - -type: long - --- - -*`container.disk.write.bytes`*:: -+ --- -The total number of bytes (gauge) written successfully (aggregated from all disks) since the last metric collection. - -type: long - --- - -*`container.id`*:: -+ --- -Unique container id. - -type: keyword - --- - -*`container.image.name`*:: -+ --- -Name of the image the container was built on. - -type: keyword - --- - -*`container.image.tag`*:: -+ --- -Container image tags. - -type: keyword - --- - -*`container.labels`*:: -+ --- -Image labels. - -type: object - --- - -*`container.memory.usage`*:: -+ --- -Memory usage percentage and it ranges from 0 to 1. Scaling factor: 1000. - -type: scaled_float - --- - -*`container.name`*:: -+ --- -Container name. - -type: keyword - --- - -*`container.network.egress.bytes`*:: -+ --- -The number of bytes (gauge) sent out on all network interfaces by the container since the last metric collection. - -type: long - --- - -*`container.network.ingress.bytes`*:: -+ --- -The number of bytes received (gauge) on all network interfaces by the container since the last metric collection. - -type: long - --- - -*`container.runtime`*:: -+ --- -Runtime managing this container. - -type: keyword - -example: docker - --- - -[float] -=== data_stream - -The data_stream fields take part in defining the new data stream naming scheme. -In the new data stream naming scheme the value of the data stream fields combine to the name of the actual data stream in the following manner: `{data_stream.type}-{data_stream.dataset}-{data_stream.namespace}`. This means the fields can only contain characters that are valid as part of names of data streams. More details about this can be found in this https://www.elastic.co/blog/an-introduction-to-the-elastic-data-stream-naming-scheme[blog post]. -An Elasticsearch data stream consists of one or more backing indices, and a data stream name forms part of the backing indices names. Due to this convention, data streams must also follow index naming restrictions. For example, data stream names cannot include `\`, `/`, `*`, `?`, `"`, `<`, `>`, `|`, ` ` (space character), `,`, or `#`. Please see the Elasticsearch reference for additional https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-create-index.html#indices-create-api-path-params[restrictions]. - - -*`data_stream.dataset`*:: -+ --- -The field can contain anything that makes sense to signify the source of the data. -Examples include `nginx.access`, `prometheus`, `endpoint` etc. For data streams that otherwise fit, but that do not have dataset set we use the value "generic" for the dataset value. `event.dataset` should have the same value as `data_stream.dataset`. -Beyond the Elasticsearch data stream naming criteria noted above, the `dataset` value has additional restrictions: - * Must not contain `-` - * No longer than 100 characters - -type: constant_keyword - -example: nginx.access - --- - -*`data_stream.namespace`*:: -+ --- -A user defined namespace. Namespaces are useful to allow grouping of data. -Many users already organize their indices this way, and the data stream naming scheme now provides this best practice as a default. Many users will populate this field with `default`. If no value is used, it falls back to `default`. -Beyond the Elasticsearch index naming criteria noted above, `namespace` value has the additional restrictions: - * Must not contain `-` - * No longer than 100 characters - -type: constant_keyword - -example: production - --- - -*`data_stream.type`*:: -+ --- -An overarching type for the data stream. -Currently allowed values are "logs" and "metrics". We expect to also add "traces" and "synthetics" in the near future. - -type: constant_keyword - -example: logs - --- - -[float] -=== destination - -Destination fields capture details about the receiver of a network exchange/packet. These fields are populated from a network event, packet, or other event containing details of a network transaction. -Destination fields are usually populated in conjunction with source fields. The source and destination fields are considered the baseline and should always be filled if an event contains source and destination details from a network transaction. If the event also contains identification of the client and server roles, then the client and server fields should also be populated. - - -*`destination.address`*:: -+ --- -Some event destination addresses are defined ambiguously. The event will sometimes list an IP, a domain or a unix socket. You should always store the raw address in the `.address` field. -Then it should be duplicated to `.ip` or `.domain`, depending on which one it is. - -type: keyword - --- - -*`destination.as.number`*:: -+ --- -Unique number allocated to the autonomous system. The autonomous system number (ASN) uniquely identifies each network on the Internet. - -type: long - -example: 15169 - --- - -*`destination.as.organization.name`*:: -+ --- -Organization name. - -type: keyword - -example: Google LLC - --- - -*`destination.as.organization.name.text`*:: -+ --- -type: match_only_text - --- - -*`destination.bytes`*:: -+ --- -Bytes sent from the destination to the source. - -type: long - -example: 184 - -format: bytes - --- - -*`destination.domain`*:: -+ --- -The domain name of the destination system. -This value may be a host name, a fully qualified domain name, or another host naming format. The value may derive from the original event or be added from enrichment. - -type: keyword - -example: foo.example.com - --- - -*`destination.geo.city_name`*:: -+ --- -City name. - -type: keyword - -example: Montreal - --- - -*`destination.geo.continent_code`*:: -+ --- -Two-letter code representing continent's name. - -type: keyword - -example: NA - --- - -*`destination.geo.continent_name`*:: -+ --- -Name of the continent. - -type: keyword - -example: North America - --- - -*`destination.geo.country_iso_code`*:: -+ --- -Country ISO code. - -type: keyword - -example: CA - --- - -*`destination.geo.country_name`*:: -+ --- -Country name. - -type: keyword - -example: Canada - --- - -*`destination.geo.location`*:: -+ --- -Longitude and latitude. - -type: geo_point - -example: { "lon": -73.614830, "lat": 45.505918 } - --- - -*`destination.geo.name`*:: -+ --- -User-defined description of a location, at the level of granularity they care about. -Could be the name of their data centers, the floor number, if this describes a local physical entity, city names. -Not typically used in automated geolocation. - -type: keyword - -example: boston-dc - --- - -*`destination.geo.postal_code`*:: -+ --- -Postal code associated with the location. -Values appropriate for this field may also be known as a postcode or ZIP code and will vary widely from country to country. - -type: keyword - -example: 94040 - --- - -*`destination.geo.region_iso_code`*:: -+ --- -Region ISO code. - -type: keyword - -example: CA-QC - --- - -*`destination.geo.region_name`*:: -+ --- -Region name. - -type: keyword - -example: Quebec - --- - -*`destination.geo.timezone`*:: -+ --- -The time zone of the location, such as IANA time zone name. - -type: keyword - -example: America/Argentina/Buenos_Aires - --- - -*`destination.ip`*:: -+ --- -IP address of the destination (IPv4 or IPv6). - -type: ip - --- - -*`destination.mac`*:: -+ --- -MAC address of the destination. -The notation format from RFC 7042 is suggested: Each octet (that is, 8-bit byte) is represented by two [uppercase] hexadecimal digits giving the value of the octet as an unsigned integer. Successive octets are separated by a hyphen. - -type: keyword - -example: 00-00-5E-00-53-23 - --- - -*`destination.nat.ip`*:: -+ --- -Translated ip of destination based NAT sessions (e.g. internet to private DMZ) -Typically used with load balancers, firewalls, or routers. - -type: ip - --- - -*`destination.nat.port`*:: -+ --- -Port the source session is translated to by NAT Device. -Typically used with load balancers, firewalls, or routers. - -type: long - -format: string - --- - -*`destination.packets`*:: -+ --- -Packets sent from the destination to the source. - -type: long - -example: 12 - --- - -*`destination.port`*:: -+ --- -Port of the destination. - -type: long - -format: string - --- - -*`destination.registered_domain`*:: -+ --- -The highest registered destination domain, stripped of the subdomain. -For example, the registered domain for "foo.example.com" is "example.com". -This value can be determined precisely with a list like the public suffix list (http://publicsuffix.org). Trying to approximate this by simply taking the last two labels will not work well for TLDs such as "co.uk". - -type: keyword - -example: example.com - --- - -*`destination.subdomain`*:: -+ --- -The subdomain portion of a fully qualified domain name includes all of the names except the host name under the registered_domain. In a partially qualified domain, or if the the qualification level of the full name cannot be determined, subdomain contains all of the names below the registered domain. -For example the subdomain portion of "www.east.mydomain.co.uk" is "east". If the domain has multiple levels of subdomain, such as "sub2.sub1.example.com", the subdomain field should contain "sub2.sub1", with no trailing period. - -type: keyword - -example: east - --- - -*`destination.top_level_domain`*:: -+ --- -The effective top level domain (eTLD), also known as the domain suffix, is the last part of the domain name. For example, the top level domain for example.com is "com". -This value can be determined precisely with a list like the public suffix list (http://publicsuffix.org). Trying to approximate this by simply taking the last label will not work well for effective TLDs such as "co.uk". - -type: keyword - -example: co.uk - --- - -*`destination.user.domain`*:: -+ --- -Name of the directory the user is a member of. -For example, an LDAP or Active Directory domain name. - -type: keyword - --- - -*`destination.user.email`*:: -+ --- -User email address. - -type: keyword - --- - -*`destination.user.full_name`*:: -+ --- -User's full name, if available. - -type: keyword - -example: Albert Einstein - --- - -*`destination.user.full_name.text`*:: -+ --- -type: match_only_text - --- - -*`destination.user.group.domain`*:: -+ --- -Name of the directory the group is a member of. -For example, an LDAP or Active Directory domain name. - -type: keyword - --- - -*`destination.user.group.id`*:: -+ --- -Unique identifier for the group on the system/platform. - -type: keyword - --- - -*`destination.user.group.name`*:: -+ --- -Name of the group. - -type: keyword - --- - -*`destination.user.hash`*:: -+ --- -Unique user hash to correlate information for a user in anonymized form. -Useful if `user.id` or `user.name` contain confidential information and cannot be used. - -type: keyword - --- - -*`destination.user.id`*:: -+ --- -Unique identifier of the user. - -type: keyword - -example: S-1-5-21-202424912787-2692429404-2351956786-1000 - --- - -*`destination.user.name`*:: -+ --- -Short name or login of the user. - -type: keyword - -example: a.einstein - --- - -*`destination.user.name.text`*:: -+ --- -type: match_only_text - --- - -*`destination.user.roles`*:: -+ --- -Array of user roles at the time of the event. - -type: keyword - -example: ["kibana_admin", "reporting_user"] - --- - -[float] -=== dll - -These fields contain information about code libraries dynamically loaded into processes. - -Many operating systems refer to "shared code libraries" with different names, but this field set refers to all of the following: -* Dynamic-link library (`.dll`) commonly used on Windows -* Shared Object (`.so`) commonly used on Unix-like operating systems -* Dynamic library (`.dylib`) commonly used on macOS - - -*`dll.code_signature.digest_algorithm`*:: -+ --- -The hashing algorithm used to sign the process. -This value can distinguish signatures when a file is signed multiple times by the same signer but with a different digest algorithm. - -type: keyword - -example: sha256 - --- - -*`dll.code_signature.exists`*:: -+ --- -Boolean to capture if a signature is present. - -type: boolean - -example: true - --- - -*`dll.code_signature.signing_id`*:: -+ --- -The identifier used to sign the process. -This is used to identify the application manufactured by a software vendor. The field is relevant to Apple *OS only. - -type: keyword - -example: com.apple.xpc.proxy - --- - -*`dll.code_signature.status`*:: -+ --- -Additional information about the certificate status. -This is useful for logging cryptographic errors with the certificate validity or trust status. Leave unpopulated if the validity or trust of the certificate was unchecked. - -type: keyword - -example: ERROR_UNTRUSTED_ROOT - --- - -*`dll.code_signature.subject_name`*:: -+ --- -Subject name of the code signer - -type: keyword - -example: Microsoft Corporation - --- - -*`dll.code_signature.team_id`*:: -+ --- -The team identifier used to sign the process. -This is used to identify the team or vendor of a software product. The field is relevant to Apple *OS only. - -type: keyword - -example: EQHXZ8M8AV - --- - -*`dll.code_signature.timestamp`*:: -+ --- -Date and time when the code signature was generated and signed. - -type: date - -example: 2021-01-01T12:10:30Z - --- - -*`dll.code_signature.trusted`*:: -+ --- -Stores the trust status of the certificate chain. -Validating the trust of the certificate chain may be complicated, and this field should only be populated by tools that actively check the status. - -type: boolean - -example: true - --- - -*`dll.code_signature.valid`*:: -+ --- -Boolean to capture if the digital signature is verified against the binary content. -Leave unpopulated if a certificate was unchecked. - -type: boolean - -example: true - --- - -*`dll.hash.md5`*:: -+ --- -MD5 hash. - -type: keyword - --- - -*`dll.hash.sha1`*:: -+ --- -SHA1 hash. - -type: keyword - --- - -*`dll.hash.sha256`*:: -+ --- -SHA256 hash. - -type: keyword - --- - -*`dll.hash.sha512`*:: -+ --- -SHA512 hash. - -type: keyword - --- - -*`dll.hash.ssdeep`*:: -+ --- -SSDEEP hash. - -type: keyword - --- - -*`dll.name`*:: -+ --- -Name of the library. -This generally maps to the name of the file on disk. - -type: keyword - -example: kernel32.dll - --- - -*`dll.path`*:: -+ --- -Full file path of the library. - -type: keyword - -example: C:\Windows\System32\kernel32.dll - --- - -*`dll.pe.architecture`*:: -+ --- -CPU architecture target for the file. - -type: keyword - -example: x64 - --- - -*`dll.pe.company`*:: -+ --- -Internal company name of the file, provided at compile-time. - -type: keyword - -example: Microsoft Corporation - --- - -*`dll.pe.description`*:: -+ --- -Internal description of the file, provided at compile-time. - -type: keyword - -example: Paint - --- - -*`dll.pe.file_version`*:: -+ --- -Internal version of the file, provided at compile-time. - -type: keyword - -example: 6.3.9600.17415 - --- - -*`dll.pe.imphash`*:: -+ --- -A hash of the imports in a PE file. An imphash -- or import hash -- can be used to fingerprint binaries even after recompilation or other code-level transformations have occurred, which would change more traditional hash values. -Learn more at https://www.fireeye.com/blog/threat-research/2014/01/tracking-malware-import-hashing.html. - -type: keyword - -example: 0c6803c4e922103c4dca5963aad36ddf - --- - -*`dll.pe.original_file_name`*:: -+ --- -Internal name of the file, provided at compile-time. - -type: keyword - -example: MSPAINT.EXE - --- - -*`dll.pe.product`*:: -+ --- -Internal product name of the file, provided at compile-time. - -type: keyword - -example: Microsoft® Windows® Operating System - --- - -[float] -=== dns - -Fields describing DNS queries and answers. -DNS events should either represent a single DNS query prior to getting answers (`dns.type:query`) or they should represent a full exchange and contain the query details as well as all of the answers that were provided for this query (`dns.type:answer`). - - -*`dns.answers`*:: -+ --- -An array containing an object for each answer section returned by the server. -The main keys that should be present in these objects are defined by ECS. Records that have more information may contain more keys than what ECS defines. -Not all DNS data sources give all details about DNS answers. At minimum, answer objects must contain the `data` key. If more information is available, map as much of it to ECS as possible, and add any additional fields to the answer objects as custom fields. - -type: object - --- - -*`dns.answers.class`*:: -+ --- -The class of DNS data contained in this resource record. - -type: keyword - -example: IN - --- - -*`dns.answers.data`*:: -+ --- -The data describing the resource. -The meaning of this data depends on the type and class of the resource record. - -type: keyword - -example: 10.10.10.10 - --- - -*`dns.answers.name`*:: -+ --- -The domain name to which this resource record pertains. -If a chain of CNAME is being resolved, each answer's `name` should be the one that corresponds with the answer's `data`. It should not simply be the original `question.name` repeated. - -type: keyword - -example: www.example.com - --- - -*`dns.answers.ttl`*:: -+ --- -The time interval in seconds that this resource record may be cached before it should be discarded. Zero values mean that the data should not be cached. - -type: long - -example: 180 - --- - -*`dns.answers.type`*:: -+ --- -The type of data contained in this resource record. - -type: keyword - -example: CNAME - --- - -*`dns.header_flags`*:: -+ --- -Array of 2 letter DNS header flags. -Expected values are: AA, TC, RD, RA, AD, CD, DO. - -type: keyword - -example: ["RD", "RA"] - --- - -*`dns.id`*:: -+ --- -The DNS packet identifier assigned by the program that generated the query. The identifier is copied to the response. - -type: keyword - -example: 62111 - --- - -*`dns.op_code`*:: -+ --- -The DNS operation code that specifies the kind of query in the message. This value is set by the originator of a query and copied into the response. - -type: keyword - -example: QUERY - --- - -*`dns.question.class`*:: -+ --- -The class of records being queried. - -type: keyword - -example: IN - --- - -*`dns.question.name`*:: -+ --- -The name being queried. -If the name field contains non-printable characters (below 32 or above 126), those characters should be represented as escaped base 10 integers (\DDD). Back slashes and quotes should be escaped. Tabs, carriage returns, and line feeds should be converted to \t, \r, and \n respectively. - -type: keyword - -example: www.example.com - --- - -*`dns.question.registered_domain`*:: -+ --- -The highest registered domain, stripped of the subdomain. -For example, the registered domain for "foo.example.com" is "example.com". -This value can be determined precisely with a list like the public suffix list (http://publicsuffix.org). Trying to approximate this by simply taking the last two labels will not work well for TLDs such as "co.uk". - -type: keyword - -example: example.com - --- - -*`dns.question.subdomain`*:: -+ --- -The subdomain is all of the labels under the registered_domain. -If the domain has multiple levels of subdomain, such as "sub2.sub1.example.com", the subdomain field should contain "sub2.sub1", with no trailing period. - -type: keyword - -example: www - --- - -*`dns.question.top_level_domain`*:: -+ --- -The effective top level domain (eTLD), also known as the domain suffix, is the last part of the domain name. For example, the top level domain for example.com is "com". -This value can be determined precisely with a list like the public suffix list (http://publicsuffix.org). Trying to approximate this by simply taking the last label will not work well for effective TLDs such as "co.uk". - -type: keyword - -example: co.uk - --- - -*`dns.question.type`*:: -+ --- -The type of record being queried. - -type: keyword - -example: AAAA - --- - -*`dns.resolved_ip`*:: -+ --- -Array containing all IPs seen in `answers.data`. -The `answers` array can be difficult to use, because of the variety of data formats it can contain. Extracting all IP addresses seen in there to `dns.resolved_ip` makes it possible to index them as IP addresses, and makes them easier to visualize and query for. - -type: ip - -example: ["10.10.10.10", "10.10.10.11"] - --- - -*`dns.response_code`*:: -+ --- -The DNS response code. - -type: keyword - -example: NOERROR - --- - -*`dns.type`*:: -+ --- -The type of DNS event captured, query or answer. -If your source of DNS events only gives you DNS queries, you should only create dns events of type `dns.type:query`. -If your source of DNS events gives you answers as well, you should create one event per query (optionally as soon as the query is seen). And a second event containing all query details as well as an array of answers. - -type: keyword - -example: answer - --- - -[float] -=== ecs - -Meta-information specific to ECS. - - -*`ecs.version`*:: -+ --- -ECS version this event conforms to. `ecs.version` is a required field and must exist in all events. -When querying across multiple indices -- which may conform to slightly different ECS versions -- this field lets integrations adjust to the schema version of the events. - -type: keyword - -example: 1.0.0 - -required: True - --- - -[float] -=== elf - -These fields contain Linux Executable Linkable Format (ELF) metadata. - - -*`elf.architecture`*:: -+ --- -Machine architecture of the ELF file. - -type: keyword - -example: x86-64 - --- - -*`elf.byte_order`*:: -+ --- -Byte sequence of ELF file. - -type: keyword - -example: Little Endian - --- - -*`elf.cpu_type`*:: -+ --- -CPU type of the ELF file. - -type: keyword - -example: Intel - --- - -*`elf.creation_date`*:: -+ --- -Extracted when possible from the file's metadata. Indicates when it was built or compiled. It can also be faked by malware creators. - -type: date - --- - -*`elf.exports`*:: -+ --- -List of exported element names and types. - -type: flattened - --- - -*`elf.header.abi_version`*:: -+ --- -Version of the ELF Application Binary Interface (ABI). - -type: keyword - --- - -*`elf.header.class`*:: -+ --- -Header class of the ELF file. - -type: keyword - --- - -*`elf.header.data`*:: -+ --- -Data table of the ELF header. - -type: keyword - --- - -*`elf.header.entrypoint`*:: -+ --- -Header entrypoint of the ELF file. - -type: long - -format: string - --- - -*`elf.header.object_version`*:: -+ --- -"0x1" for original ELF files. - -type: keyword - --- - -*`elf.header.os_abi`*:: -+ --- -Application Binary Interface (ABI) of the Linux OS. - -type: keyword - --- - -*`elf.header.type`*:: -+ --- -Header type of the ELF file. - -type: keyword - --- - -*`elf.header.version`*:: -+ --- -Version of the ELF header. - -type: keyword - --- - -*`elf.imports`*:: -+ --- -List of imported element names and types. - -type: flattened - --- - -*`elf.sections`*:: -+ --- -An array containing an object for each section of the ELF file. -The keys that should be present in these objects are defined by sub-fields underneath `elf.sections.*`. - -type: nested - --- - -*`elf.sections.chi2`*:: -+ --- -Chi-square probability distribution of the section. - -type: long - -format: number - --- - -*`elf.sections.entropy`*:: -+ --- -Shannon entropy calculation from the section. - -type: long - -format: number - --- - -*`elf.sections.flags`*:: -+ --- -ELF Section List flags. - -type: keyword - --- - -*`elf.sections.name`*:: -+ --- -ELF Section List name. - -type: keyword - --- - -*`elf.sections.physical_offset`*:: -+ --- -ELF Section List offset. - -type: keyword - --- - -*`elf.sections.physical_size`*:: -+ --- -ELF Section List physical size. - -type: long - -format: bytes - --- - -*`elf.sections.type`*:: -+ --- -ELF Section List type. - -type: keyword - --- - -*`elf.sections.virtual_address`*:: -+ --- -ELF Section List virtual address. - -type: long - -format: string - --- - -*`elf.sections.virtual_size`*:: -+ --- -ELF Section List virtual size. - -type: long - -format: string - --- - -*`elf.segments`*:: -+ --- -An array containing an object for each segment of the ELF file. -The keys that should be present in these objects are defined by sub-fields underneath `elf.segments.*`. - -type: nested - --- - -*`elf.segments.sections`*:: -+ --- -ELF object segment sections. - -type: keyword - --- - -*`elf.segments.type`*:: -+ --- -ELF object segment type. - -type: keyword - --- - -*`elf.shared_libraries`*:: -+ --- -List of shared libraries used by this ELF object. - -type: keyword - --- - -*`elf.telfhash`*:: -+ --- -telfhash symbol hash for ELF file. - -type: keyword - --- - -[float] -=== error - -These fields can represent errors of any kind. -Use them for errors that happen while fetching events or in cases where the event itself contains an error. - - -*`error.code`*:: -+ --- -Error code describing the error. - -type: keyword - --- - -*`error.id`*:: -+ --- -Unique identifier for the error. - -type: keyword - --- - -*`error.message`*:: -+ --- -Error message. - -type: match_only_text - --- - -*`error.stack_trace`*:: -+ --- -The stack trace of this error in plain text. - -type: wildcard - --- - -*`error.stack_trace.text`*:: -+ --- -type: match_only_text - --- - -*`error.type`*:: -+ --- -The type of the error, for example the class name of the exception. - -type: keyword - -example: java.lang.NullPointerException - --- - -[float] -=== event - -The event fields are used for context information about the log or metric event itself. -A log is defined as an event containing details of something that happened. Log events must include the time at which the thing happened. Examples of log events include a process starting on a host, a network packet being sent from a source to a destination, or a network connection between a client and a server being initiated or closed. A metric is defined as an event containing one or more numerical measurements and the time at which the measurement was taken. Examples of metric events include memory pressure measured on a host and device temperature. See the `event.kind` definition in this section for additional details about metric and state events. - - -*`event.action`*:: -+ --- -The action captured by the event. -This describes the information in the event. It is more specific than `event.category`. Examples are `group-add`, `process-started`, `file-created`. The value is normally defined by the implementer. - -type: keyword - -example: user-password-change - --- - -*`event.agent_id_status`*:: -+ --- -Agents are normally responsible for populating the `agent.id` field value. If the system receiving events is capable of validating the value based on authentication information for the client then this field can be used to reflect the outcome of that validation. -For example if the agent's connection is authenticated with mTLS and the client cert contains the ID of the agent to which the cert was issued then the `agent.id` value in events can be checked against the certificate. If the values match then `event.agent_id_status: verified` is added to the event, otherwise one of the other allowed values should be used. -If no validation is performed then the field should be omitted. -The allowed values are: -`verified` - The `agent.id` field value matches expected value obtained from auth metadata. -`mismatch` - The `agent.id` field value does not match the expected value obtained from auth metadata. -`missing` - There was no `agent.id` field in the event to validate. -`auth_metadata_missing` - There was no auth metadata or it was missing information about the agent ID. - -type: keyword - -example: verified - --- - -*`event.category`*:: -+ --- -This is one of four ECS Categorization Fields, and indicates the second level in the ECS category hierarchy. -`event.category` represents the "big buckets" of ECS categories. For example, filtering on `event.category:process` yields all events relating to process activity. This field is closely related to `event.type`, which is used as a subcategory. -This field is an array. This will allow proper categorization of some events that fall in multiple categories. - -type: keyword - -example: authentication - --- - -*`event.code`*:: -+ --- -Identification code for this event, if one exists. -Some event sources use event codes to identify messages unambiguously, regardless of message language or wording adjustments over time. An example of this is the Windows Event ID. - -type: keyword - -example: 4648 - --- - -*`event.created`*:: -+ --- -event.created contains the date/time when the event was first read by an agent, or by your pipeline. -This field is distinct from @timestamp in that @timestamp typically contain the time extracted from the original event. -In most situations, these two timestamps will be slightly different. The difference can be used to calculate the delay between your source generating an event, and the time when your agent first processed it. This can be used to monitor your agent's or pipeline's ability to keep up with your event source. -In case the two timestamps are identical, @timestamp should be used. - -type: date - -example: 2016-05-23T08:05:34.857Z - --- - -*`event.dataset`*:: -+ --- -Name of the dataset. -If an event source publishes more than one type of log or events (e.g. access log, error log), the dataset is used to specify which one the event comes from. -It's recommended but not required to start the dataset name with the module name, followed by a dot, then the dataset name. - -type: keyword - -example: apache.access - --- - -*`event.duration`*:: -+ --- -Duration of the event in nanoseconds. -If event.start and event.end are known this value should be the difference between the end and start time. - -type: long - -format: duration - --- - -*`event.end`*:: -+ --- -event.end contains the date when the event ended or when the activity was last observed. - -type: date - --- - -*`event.hash`*:: -+ --- -Hash (perhaps logstash fingerprint) of raw field to be able to demonstrate log integrity. - -type: keyword - -example: 123456789012345678901234567890ABCD - --- - -*`event.id`*:: -+ --- -Unique ID to describe the event. - -type: keyword - -example: 8a4f500d - --- - -*`event.ingested`*:: -+ --- -Timestamp when an event arrived in the central data store. -This is different from `@timestamp`, which is when the event originally occurred. It's also different from `event.created`, which is meant to capture the first time an agent saw the event. -In normal conditions, assuming no tampering, the timestamps should chronologically look like this: `@timestamp` < `event.created` < `event.ingested`. - -type: date - -example: 2016-05-23T08:05:35.101Z - --- - -*`event.kind`*:: -+ --- -This is one of four ECS Categorization Fields, and indicates the highest level in the ECS category hierarchy. -`event.kind` gives high-level information about what type of information the event contains, without being specific to the contents of the event. For example, values of this field distinguish alert events from metric events. -The value of this field can be used to inform how these kinds of events should be handled. They may warrant different retention, different access control, it may also help understand whether the data coming in at a regular interval or not. - -type: keyword - -example: alert - --- - -*`event.module`*:: -+ --- -Name of the module this data is coming from. -If your monitoring agent supports the concept of modules or plugins to process events of a given source (e.g. Apache logs), `event.module` should contain the name of this module. - -type: keyword - -example: apache - --- - -*`event.original`*:: -+ --- -Raw text message of entire event. Used to demonstrate log integrity or where the full log message (before splitting it up in multiple parts) may be required, e.g. for reindex. -This field is not indexed and doc_values are disabled. It cannot be searched, but it can be retrieved from `_source`. If users wish to override this and index this field, please see `Field data types` in the `Elasticsearch Reference`. - -type: keyword - -example: Sep 19 08:26:10 host CEF:0|Security| threatmanager|1.0|100| worm successfully stopped|10|src=10.0.0.1 dst=2.1.2.2spt=1232 - -Field is not indexed. - --- - -*`event.outcome`*:: -+ --- -This is one of four ECS Categorization Fields, and indicates the lowest level in the ECS category hierarchy. -`event.outcome` simply denotes whether the event represents a success or a failure from the perspective of the entity that produced the event. -Note that when a single transaction is described in multiple events, each event may populate different values of `event.outcome`, according to their perspective. -Also note that in the case of a compound event (a single event that contains multiple logical events), this field should be populated with the value that best captures the overall success or failure from the perspective of the event producer. -Further note that not all events will have an associated outcome. For example, this field is generally not populated for metric events, events with `event.type:info`, or any events for which an outcome does not make logical sense. - -type: keyword - -example: success - --- - -*`event.provider`*:: -+ --- -Source of the event. -Event transports such as Syslog or the Windows Event Log typically mention the source of an event. It can be the name of the software that generated the event (e.g. Sysmon, httpd), or of a subsystem of the operating system (kernel, Microsoft-Windows-Security-Auditing). - -type: keyword - -example: kernel - --- - -*`event.reason`*:: -+ --- -Reason why this event happened, according to the source. -This describes the why of a particular action or outcome captured in the event. Where `event.action` captures the action from the event, `event.reason` describes why that action was taken. For example, a web proxy with an `event.action` which denied the request may also populate `event.reason` with the reason why (e.g. `blocked site`). - -type: keyword - -example: Terminated an unexpected process - --- - -*`event.reference`*:: -+ --- -Reference URL linking to additional information about this event. -This URL links to a static definition of this event. Alert events, indicated by `event.kind:alert`, are a common use case for this field. - -type: keyword - -example: https://system.example.com/event/#0001234 - --- - -*`event.risk_score`*:: -+ --- -Risk score or priority of the event (e.g. security solutions). Use your system's original value here. - -type: float - --- - -*`event.risk_score_norm`*:: -+ --- -Normalized risk score or priority of the event, on a scale of 0 to 100. -This is mainly useful if you use more than one system that assigns risk scores, and you want to see a normalized value across all systems. - -type: float - --- - -*`event.sequence`*:: -+ --- -Sequence number of the event. -The sequence number is a value published by some event sources, to make the exact ordering of events unambiguous, regardless of the timestamp precision. - -type: long - -format: string - --- - -*`event.severity`*:: -+ --- -The numeric severity of the event according to your event source. -What the different severity values mean can be different between sources and use cases. It's up to the implementer to make sure severities are consistent across events from the same source. -The Syslog severity belongs in `log.syslog.severity.code`. `event.severity` is meant to represent the severity according to the event source (e.g. firewall, IDS). If the event source does not publish its own severity, you may optionally copy the `log.syslog.severity.code` to `event.severity`. - -type: long - -example: 7 - -format: string - --- - -*`event.start`*:: -+ --- -event.start contains the date when the event started or when the activity was first observed. - -type: date - --- - -*`event.timezone`*:: -+ --- -This field should be populated when the event's timestamp does not include timezone information already (e.g. default Syslog timestamps). It's optional otherwise. -Acceptable timezone formats are: a canonical ID (e.g. "Europe/Amsterdam"), abbreviated (e.g. "EST") or an HH:mm differential (e.g. "-05:00"). - -type: keyword - --- - -*`event.type`*:: -+ --- -This is one of four ECS Categorization Fields, and indicates the third level in the ECS category hierarchy. -`event.type` represents a categorization "sub-bucket" that, when used along with the `event.category` field values, enables filtering events down to a level appropriate for single visualization. -This field is an array. This will allow proper categorization of some events that fall in multiple event types. - -type: keyword - --- - -*`event.url`*:: -+ --- -URL linking to an external system to continue investigation of this event. -This URL links to another system where in-depth investigation of the specific occurrence of this event can take place. Alert events, indicated by `event.kind:alert`, are a common use case for this field. - -type: keyword - -example: https://mysystem.example.com/alert/5271dedb-f5b0-4218-87f0-4ac4870a38fe - --- - -[float] -=== faas - -The user fields describe information about the function as a service that is relevant to the event. - - -*`faas.coldstart`*:: -+ --- -Boolean value indicating a cold start of a function. - -type: boolean - --- - -*`faas.execution`*:: -+ --- -The execution ID of the current function execution. - -type: keyword - -example: af9d5aa4-a685-4c5f-a22b-444f80b3cc28 - --- - -*`faas.trigger`*:: -+ --- -Details about the function trigger. - -type: nested - --- - -*`faas.trigger.request_id`*:: -+ --- -The ID of the trigger request , message, event, etc. - -type: keyword - -example: 123456789 - --- - -*`faas.trigger.type`*:: -+ --- -The trigger for the function execution. -Expected values are: - * http - * pubsub - * datasource - * timer - * other - -type: keyword - -example: http - --- - -[float] -=== file - -A file is defined as a set of information that has been created on, or has existed on a filesystem. -File objects can be associated with host events, network events, and/or file events (e.g., those produced by File Integrity Monitoring [FIM] products or services). File fields provide details about the affected file associated with the event or metric. - - -*`file.accessed`*:: -+ --- -Last time the file was accessed. -Note that not all filesystems keep track of access time. - -type: date - --- - -*`file.attributes`*:: -+ --- -Array of file attributes. -Attributes names will vary by platform. Here's a non-exhaustive list of values that are expected in this field: archive, compressed, directory, encrypted, execute, hidden, read, readonly, system, write. - -type: keyword - -example: ["readonly", "system"] - --- - -*`file.code_signature.digest_algorithm`*:: -+ --- -The hashing algorithm used to sign the process. -This value can distinguish signatures when a file is signed multiple times by the same signer but with a different digest algorithm. - -type: keyword - -example: sha256 - --- - -*`file.code_signature.exists`*:: -+ --- -Boolean to capture if a signature is present. - -type: boolean - -example: true - --- - -*`file.code_signature.signing_id`*:: -+ --- -The identifier used to sign the process. -This is used to identify the application manufactured by a software vendor. The field is relevant to Apple *OS only. - -type: keyword - -example: com.apple.xpc.proxy - --- - -*`file.code_signature.status`*:: -+ --- -Additional information about the certificate status. -This is useful for logging cryptographic errors with the certificate validity or trust status. Leave unpopulated if the validity or trust of the certificate was unchecked. - -type: keyword - -example: ERROR_UNTRUSTED_ROOT - --- - -*`file.code_signature.subject_name`*:: -+ --- -Subject name of the code signer - -type: keyword - -example: Microsoft Corporation - --- - -*`file.code_signature.team_id`*:: -+ --- -The team identifier used to sign the process. -This is used to identify the team or vendor of a software product. The field is relevant to Apple *OS only. - -type: keyword - -example: EQHXZ8M8AV - --- - -*`file.code_signature.timestamp`*:: -+ --- -Date and time when the code signature was generated and signed. - -type: date - -example: 2021-01-01T12:10:30Z - --- - -*`file.code_signature.trusted`*:: -+ --- -Stores the trust status of the certificate chain. -Validating the trust of the certificate chain may be complicated, and this field should only be populated by tools that actively check the status. - -type: boolean - -example: true - --- - -*`file.code_signature.valid`*:: -+ --- -Boolean to capture if the digital signature is verified against the binary content. -Leave unpopulated if a certificate was unchecked. - -type: boolean - -example: true - --- - -*`file.created`*:: -+ --- -File creation time. -Note that not all filesystems store the creation time. - -type: date - --- - -*`file.ctime`*:: -+ --- -Last time the file attributes or metadata changed. -Note that changes to the file content will update `mtime`. This implies `ctime` will be adjusted at the same time, since `mtime` is an attribute of the file. - -type: date - --- - -*`file.device`*:: -+ --- -Device that is the source of the file. - -type: keyword - -example: sda - --- - -*`file.directory`*:: -+ --- -Directory where the file is located. It should include the drive letter, when appropriate. - -type: keyword - -example: /home/alice - --- - -*`file.drive_letter`*:: -+ --- -Drive letter where the file is located. This field is only relevant on Windows. -The value should be uppercase, and not include the colon. - -type: keyword - -example: C - --- - -*`file.elf.architecture`*:: -+ --- -Machine architecture of the ELF file. - -type: keyword - -example: x86-64 - --- - -*`file.elf.byte_order`*:: -+ --- -Byte sequence of ELF file. - -type: keyword - -example: Little Endian - --- - -*`file.elf.cpu_type`*:: -+ --- -CPU type of the ELF file. - -type: keyword - -example: Intel - --- - -*`file.elf.creation_date`*:: -+ --- -Extracted when possible from the file's metadata. Indicates when it was built or compiled. It can also be faked by malware creators. - -type: date - --- - -*`file.elf.exports`*:: -+ --- -List of exported element names and types. - -type: flattened - --- - -*`file.elf.header.abi_version`*:: -+ --- -Version of the ELF Application Binary Interface (ABI). - -type: keyword - --- - -*`file.elf.header.class`*:: -+ --- -Header class of the ELF file. - -type: keyword - --- - -*`file.elf.header.data`*:: -+ --- -Data table of the ELF header. - -type: keyword - --- - -*`file.elf.header.entrypoint`*:: -+ --- -Header entrypoint of the ELF file. - -type: long - -format: string - --- - -*`file.elf.header.object_version`*:: -+ --- -"0x1" for original ELF files. - -type: keyword - --- - -*`file.elf.header.os_abi`*:: -+ --- -Application Binary Interface (ABI) of the Linux OS. - -type: keyword - --- - -*`file.elf.header.type`*:: -+ --- -Header type of the ELF file. - -type: keyword - --- - -*`file.elf.header.version`*:: -+ --- -Version of the ELF header. - -type: keyword - --- - -*`file.elf.imports`*:: -+ --- -List of imported element names and types. - -type: flattened - --- - -*`file.elf.sections`*:: -+ --- -An array containing an object for each section of the ELF file. -The keys that should be present in these objects are defined by sub-fields underneath `elf.sections.*`. - -type: nested - --- - -*`file.elf.sections.chi2`*:: -+ --- -Chi-square probability distribution of the section. - -type: long - -format: number - --- - -*`file.elf.sections.entropy`*:: -+ --- -Shannon entropy calculation from the section. - -type: long - -format: number - --- - -*`file.elf.sections.flags`*:: -+ --- -ELF Section List flags. - -type: keyword - --- - -*`file.elf.sections.name`*:: -+ --- -ELF Section List name. - -type: keyword - --- - -*`file.elf.sections.physical_offset`*:: -+ --- -ELF Section List offset. - -type: keyword - --- - -*`file.elf.sections.physical_size`*:: -+ --- -ELF Section List physical size. - -type: long - -format: bytes - --- - -*`file.elf.sections.type`*:: -+ --- -ELF Section List type. - -type: keyword - --- - -*`file.elf.sections.virtual_address`*:: -+ --- -ELF Section List virtual address. - -type: long - -format: string - --- - -*`file.elf.sections.virtual_size`*:: -+ --- -ELF Section List virtual size. - -type: long - -format: string - --- - -*`file.elf.segments`*:: -+ --- -An array containing an object for each segment of the ELF file. -The keys that should be present in these objects are defined by sub-fields underneath `elf.segments.*`. - -type: nested - --- - -*`file.elf.segments.sections`*:: -+ --- -ELF object segment sections. - -type: keyword - --- - -*`file.elf.segments.type`*:: -+ --- -ELF object segment type. - -type: keyword - --- - -*`file.elf.shared_libraries`*:: -+ --- -List of shared libraries used by this ELF object. - -type: keyword - --- - -*`file.elf.telfhash`*:: -+ --- -telfhash symbol hash for ELF file. - -type: keyword - --- - -*`file.extension`*:: -+ --- -File extension, excluding the leading dot. -Note that when the file name has multiple extensions (example.tar.gz), only the last one should be captured ("gz", not "tar.gz"). - -type: keyword - -example: png - --- - -*`file.fork_name`*:: -+ --- -A fork is additional data associated with a filesystem object. -On Linux, a resource fork is used to store additional data with a filesystem object. A file always has at least one fork for the data portion, and additional forks may exist. -On NTFS, this is analogous to an Alternate Data Stream (ADS), and the default data stream for a file is just called $DATA. Zone.Identifier is commonly used by Windows to track contents downloaded from the Internet. An ADS is typically of the form: `C:\path\to\filename.extension:some_fork_name`, and `some_fork_name` is the value that should populate `fork_name`. `filename.extension` should populate `file.name`, and `extension` should populate `file.extension`. The full path, `file.path`, will include the fork name. - -type: keyword - -example: Zone.Identifer - --- - -*`file.gid`*:: -+ --- -Primary group ID (GID) of the file. - -type: keyword - -example: 1001 - --- - -*`file.group`*:: -+ --- -Primary group name of the file. - -type: keyword - -example: alice - --- - -*`file.hash.md5`*:: -+ --- -MD5 hash. - -type: keyword - --- - -*`file.hash.sha1`*:: -+ --- -SHA1 hash. - -type: keyword - --- - -*`file.hash.sha256`*:: -+ --- -SHA256 hash. - -type: keyword - --- - -*`file.hash.sha512`*:: -+ --- -SHA512 hash. - -type: keyword - --- - -*`file.hash.ssdeep`*:: -+ --- -SSDEEP hash. - -type: keyword - --- - -*`file.inode`*:: -+ --- -Inode representing the file in the filesystem. - -type: keyword - -example: 256383 - --- - -*`file.mime_type`*:: -+ --- -MIME type should identify the format of the file or stream of bytes using https://www.iana.org/assignments/media-types/media-types.xhtml[IANA official types], where possible. When more than one type is applicable, the most specific type should be used. - -type: keyword - --- - -*`file.mode`*:: -+ --- -Mode of the file in octal representation. - -type: keyword - -example: 0640 - --- - -*`file.mtime`*:: -+ --- -Last time the file content was modified. - -type: date - --- - -*`file.name`*:: -+ --- -Name of the file including the extension, without the directory. - -type: keyword - -example: example.png - --- - -*`file.owner`*:: -+ --- -File owner's username. - -type: keyword - -example: alice - --- - -*`file.path`*:: -+ --- -Full path to the file, including the file name. It should include the drive letter, when appropriate. - -type: keyword - -example: /home/alice/example.png - --- - -*`file.path.text`*:: -+ --- -type: match_only_text - --- - -*`file.pe.architecture`*:: -+ --- -CPU architecture target for the file. - -type: keyword - -example: x64 - --- - -*`file.pe.company`*:: -+ --- -Internal company name of the file, provided at compile-time. - -type: keyword - -example: Microsoft Corporation - --- - -*`file.pe.description`*:: -+ --- -Internal description of the file, provided at compile-time. - -type: keyword - -example: Paint - --- - -*`file.pe.file_version`*:: -+ --- -Internal version of the file, provided at compile-time. - -type: keyword - -example: 6.3.9600.17415 - --- - -*`file.pe.imphash`*:: -+ --- -A hash of the imports in a PE file. An imphash -- or import hash -- can be used to fingerprint binaries even after recompilation or other code-level transformations have occurred, which would change more traditional hash values. -Learn more at https://www.fireeye.com/blog/threat-research/2014/01/tracking-malware-import-hashing.html. - -type: keyword - -example: 0c6803c4e922103c4dca5963aad36ddf - --- - -*`file.pe.original_file_name`*:: -+ --- -Internal name of the file, provided at compile-time. - -type: keyword - -example: MSPAINT.EXE - --- - -*`file.pe.product`*:: -+ --- -Internal product name of the file, provided at compile-time. - -type: keyword - -example: Microsoft® Windows® Operating System - --- - -*`file.size`*:: -+ --- -File size in bytes. -Only relevant when `file.type` is "file". - -type: long - -example: 16384 - --- - -*`file.target_path`*:: -+ --- -Target path for symlinks. - -type: keyword - --- - -*`file.target_path.text`*:: -+ --- -type: match_only_text - --- - -*`file.type`*:: -+ --- -File type (file, dir, or symlink). - -type: keyword - -example: file - --- - -*`file.uid`*:: -+ --- -The user ID (UID) or security identifier (SID) of the file owner. - -type: keyword - -example: 1001 - --- - -*`file.x509.alternative_names`*:: -+ --- -List of subject alternative names (SAN). Name types vary by certificate authority and certificate type but commonly contain IP addresses, DNS names (and wildcards), and email addresses. - -type: keyword - -example: *.elastic.co - --- - -*`file.x509.issuer.common_name`*:: -+ --- -List of common name (CN) of issuing certificate authority. - -type: keyword - -example: Example SHA2 High Assurance Server CA - --- - -*`file.x509.issuer.country`*:: -+ --- -List of country (C) codes - -type: keyword - -example: US - --- - -*`file.x509.issuer.distinguished_name`*:: -+ --- -Distinguished name (DN) of issuing certificate authority. - -type: keyword - -example: C=US, O=Example Inc, OU=www.example.com, CN=Example SHA2 High Assurance Server CA - --- - -*`file.x509.issuer.locality`*:: -+ --- -List of locality names (L) - -type: keyword - -example: Mountain View - --- - -*`file.x509.issuer.organization`*:: -+ --- -List of organizations (O) of issuing certificate authority. - -type: keyword - -example: Example Inc - --- - -*`file.x509.issuer.organizational_unit`*:: -+ --- -List of organizational units (OU) of issuing certificate authority. - -type: keyword - -example: www.example.com - --- - -*`file.x509.issuer.state_or_province`*:: -+ --- -List of state or province names (ST, S, or P) - -type: keyword - -example: California - --- - -*`file.x509.not_after`*:: -+ --- -Time at which the certificate is no longer considered valid. - -type: date - -example: 2020-07-16 03:15:39+00:00 - --- - -*`file.x509.not_before`*:: -+ --- -Time at which the certificate is first considered valid. - -type: date - -example: 2019-08-16 01:40:25+00:00 - --- - -*`file.x509.public_key_algorithm`*:: -+ --- -Algorithm used to generate the public key. - -type: keyword - -example: RSA - --- - -*`file.x509.public_key_curve`*:: -+ --- -The curve used by the elliptic curve public key algorithm. This is algorithm specific. - -type: keyword - -example: nistp521 - --- - -*`file.x509.public_key_exponent`*:: -+ --- -Exponent used to derive the public key. This is algorithm specific. - -type: long - -example: 65537 - -Field is not indexed. - --- - -*`file.x509.public_key_size`*:: -+ --- -The size of the public key space in bits. - -type: long - -example: 2048 - --- - -*`file.x509.serial_number`*:: -+ --- -Unique serial number issued by the certificate authority. For consistency, if this value is alphanumeric, it should be formatted without colons and uppercase characters. - -type: keyword - -example: 55FBB9C7DEBF09809D12CCAA - --- - -*`file.x509.signature_algorithm`*:: -+ --- -Identifier for certificate signature algorithm. We recommend using names found in Go Lang Crypto library. See https://github.com/golang/go/blob/go1.14/src/crypto/x509/x509.go#L337-L353. - -type: keyword - -example: SHA256-RSA - --- - -*`file.x509.subject.common_name`*:: -+ --- -List of common names (CN) of subject. - -type: keyword - -example: shared.global.example.net - --- - -*`file.x509.subject.country`*:: -+ --- -List of country (C) code - -type: keyword - -example: US - --- - -*`file.x509.subject.distinguished_name`*:: -+ --- -Distinguished name (DN) of the certificate subject entity. - -type: keyword - -example: C=US, ST=California, L=San Francisco, O=Example, Inc., CN=shared.global.example.net - --- - -*`file.x509.subject.locality`*:: -+ --- -List of locality names (L) - -type: keyword - -example: San Francisco - --- - -*`file.x509.subject.organization`*:: -+ --- -List of organizations (O) of subject. - -type: keyword - -example: Example, Inc. - --- - -*`file.x509.subject.organizational_unit`*:: -+ --- -List of organizational units (OU) of subject. - -type: keyword - --- - -*`file.x509.subject.state_or_province`*:: -+ --- -List of state or province names (ST, S, or P) - -type: keyword - -example: California - --- - -*`file.x509.version_number`*:: -+ --- -Version of x509 format. - -type: keyword - -example: 3 - --- - -[float] -=== geo - -Geo fields can carry data about a specific location related to an event. -This geolocation information can be derived from techniques such as Geo IP, or be user-supplied. - - -*`geo.city_name`*:: -+ --- -City name. - -type: keyword - -example: Montreal - --- - -*`geo.continent_code`*:: -+ --- -Two-letter code representing continent's name. - -type: keyword - -example: NA - --- - -*`geo.continent_name`*:: -+ --- -Name of the continent. - -type: keyword - -example: North America - --- - -*`geo.country_iso_code`*:: -+ --- -Country ISO code. - -type: keyword - -example: CA - --- - -*`geo.country_name`*:: -+ --- -Country name. - -type: keyword - -example: Canada - --- - -*`geo.location`*:: -+ --- -Longitude and latitude. - -type: geo_point - -example: { "lon": -73.614830, "lat": 45.505918 } - --- - -*`geo.name`*:: -+ --- -User-defined description of a location, at the level of granularity they care about. -Could be the name of their data centers, the floor number, if this describes a local physical entity, city names. -Not typically used in automated geolocation. - -type: keyword - -example: boston-dc - --- - -*`geo.postal_code`*:: -+ --- -Postal code associated with the location. -Values appropriate for this field may also be known as a postcode or ZIP code and will vary widely from country to country. - -type: keyword - -example: 94040 - --- - -*`geo.region_iso_code`*:: -+ --- -Region ISO code. - -type: keyword - -example: CA-QC - --- - -*`geo.region_name`*:: -+ --- -Region name. - -type: keyword - -example: Quebec - --- - -*`geo.timezone`*:: -+ --- -The time zone of the location, such as IANA time zone name. - -type: keyword - -example: America/Argentina/Buenos_Aires - --- - -[float] -=== group - -The group fields are meant to represent groups that are relevant to the event. - - -*`group.domain`*:: -+ --- -Name of the directory the group is a member of. -For example, an LDAP or Active Directory domain name. - -type: keyword - --- - -*`group.id`*:: -+ --- -Unique identifier for the group on the system/platform. - -type: keyword - --- - -*`group.name`*:: -+ --- -Name of the group. - -type: keyword - --- - -[float] -=== hash - -The hash fields represent different bitwise hash algorithms and their values. -Field names for common hashes (e.g. MD5, SHA1) are predefined. Add fields for other hashes by lowercasing the hash algorithm name and using underscore separators as appropriate (snake case, e.g. sha3_512). -Note that this fieldset is used for common hashes that may be computed over a range of generic bytes. Entity-specific hashes such as ja3 or imphash are placed in the fieldsets to which they relate (tls and pe, respectively). - - -*`hash.md5`*:: -+ --- -MD5 hash. - -type: keyword - --- - -*`hash.sha1`*:: -+ --- -SHA1 hash. - -type: keyword - --- - -*`hash.sha256`*:: -+ --- -SHA256 hash. - -type: keyword - --- - -*`hash.sha512`*:: -+ --- -SHA512 hash. - -type: keyword - --- - -*`hash.ssdeep`*:: -+ --- -SSDEEP hash. - -type: keyword - --- - -[float] -=== host - -A host is defined as a general computing instance. -ECS host.* fields should be populated with details about the host on which the event happened, or from which the measurement was taken. Host types include hardware, virtual machines, Docker containers, and Kubernetes nodes. - - -*`host.architecture`*:: -+ --- -Operating system architecture. - -type: keyword - -example: x86_64 - --- - -*`host.cpu.usage`*:: -+ --- -Percent CPU used which is normalized by the number of CPU cores and it ranges from 0 to 1. -Scaling factor: 1000. -For example: For a two core host, this value should be the average of the two cores, between 0 and 1. - -type: scaled_float - --- - -*`host.disk.read.bytes`*:: -+ --- -The total number of bytes (gauge) read successfully (aggregated from all disks) since the last metric collection. - -type: long - --- - -*`host.disk.write.bytes`*:: -+ --- -The total number of bytes (gauge) written successfully (aggregated from all disks) since the last metric collection. - -type: long - --- - -*`host.domain`*:: -+ --- -Name of the domain of which the host is a member. -For example, on Windows this could be the host's Active Directory domain or NetBIOS domain name. For Linux this could be the domain of the host's LDAP provider. - -type: keyword - -example: CONTOSO - --- - -*`host.geo.city_name`*:: -+ --- -City name. - -type: keyword - -example: Montreal - --- - -*`host.geo.continent_code`*:: -+ --- -Two-letter code representing continent's name. - -type: keyword - -example: NA - --- - -*`host.geo.continent_name`*:: -+ --- -Name of the continent. - -type: keyword - -example: North America - --- - -*`host.geo.country_iso_code`*:: -+ --- -Country ISO code. - -type: keyword - -example: CA - --- - -*`host.geo.country_name`*:: -+ --- -Country name. - -type: keyword - -example: Canada - --- - -*`host.geo.location`*:: -+ --- -Longitude and latitude. - -type: geo_point - -example: { "lon": -73.614830, "lat": 45.505918 } - --- - -*`host.geo.name`*:: -+ --- -User-defined description of a location, at the level of granularity they care about. -Could be the name of their data centers, the floor number, if this describes a local physical entity, city names. -Not typically used in automated geolocation. - -type: keyword - -example: boston-dc - --- - -*`host.geo.postal_code`*:: -+ --- -Postal code associated with the location. -Values appropriate for this field may also be known as a postcode or ZIP code and will vary widely from country to country. - -type: keyword - -example: 94040 - --- - -*`host.geo.region_iso_code`*:: -+ --- -Region ISO code. - -type: keyword - -example: CA-QC - --- - -*`host.geo.region_name`*:: -+ --- -Region name. - -type: keyword - -example: Quebec - --- - -*`host.geo.timezone`*:: -+ --- -The time zone of the location, such as IANA time zone name. - -type: keyword - -example: America/Argentina/Buenos_Aires - --- - -*`host.hostname`*:: -+ --- -Hostname of the host. -It normally contains what the `hostname` command returns on the host machine. - -type: keyword - --- - -*`host.id`*:: -+ --- -Unique host id. -As hostname is not always unique, use values that are meaningful in your environment. -Example: The current usage of `beat.name`. - -type: keyword - --- - -*`host.ip`*:: -+ --- -Host ip addresses. - -type: ip - --- - -*`host.mac`*:: -+ --- -Host MAC addresses. -The notation format from RFC 7042 is suggested: Each octet (that is, 8-bit byte) is represented by two [uppercase] hexadecimal digits giving the value of the octet as an unsigned integer. Successive octets are separated by a hyphen. - -type: keyword - -example: ["00-00-5E-00-53-23", "00-00-5E-00-53-24"] - --- - -*`host.name`*:: -+ --- -Name of the host. -It can contain what `hostname` returns on Unix systems, the fully qualified domain name, or a name specified by the user. The sender decides which value to use. - -type: keyword - --- - -*`host.network.egress.bytes`*:: -+ --- -The number of bytes (gauge) sent out on all network interfaces by the host since the last metric collection. - -type: long - --- - -*`host.network.egress.packets`*:: -+ --- -The number of packets (gauge) sent out on all network interfaces by the host since the last metric collection. - -type: long - --- - -*`host.network.ingress.bytes`*:: -+ --- -The number of bytes received (gauge) on all network interfaces by the host since the last metric collection. - -type: long - --- - -*`host.network.ingress.packets`*:: -+ --- -The number of packets (gauge) received on all network interfaces by the host since the last metric collection. - -type: long - --- - -*`host.os.family`*:: -+ --- -OS family (such as redhat, debian, freebsd, windows). - -type: keyword - -example: debian - --- - -*`host.os.full`*:: -+ --- -Operating system name, including the version or code name. - -type: keyword - -example: Mac OS Mojave - --- - -*`host.os.full.text`*:: -+ --- -type: match_only_text - --- - -*`host.os.kernel`*:: -+ --- -Operating system kernel version as a raw string. - -type: keyword - -example: 4.4.0-112-generic - --- - -*`host.os.name`*:: -+ --- -Operating system name, without the version. - -type: keyword - -example: Mac OS X - --- - -*`host.os.name.text`*:: -+ --- -type: match_only_text - --- - -*`host.os.platform`*:: -+ --- -Operating system platform (such centos, ubuntu, windows). - -type: keyword - -example: darwin - --- - -*`host.os.type`*:: -+ --- -Use the `os.type` field to categorize the operating system into one of the broad commercial families. -One of these following values should be used (lowercase): linux, macos, unix, windows. -If the OS you're dealing with is not in the list, the field should not be populated. Please let us know by opening an issue with ECS, to propose its addition. - -type: keyword - -example: macos - --- - -*`host.os.version`*:: -+ --- -Operating system version as a raw string. - -type: keyword - -example: 10.14.1 - --- - -*`host.type`*:: -+ --- -Type of host. -For Cloud providers this can be the machine type like `t2.medium`. If vm, this could be the container, for example, or other information meaningful in your environment. - -type: keyword - --- - -*`host.uptime`*:: -+ --- -Seconds the host has been up. - -type: long - -example: 1325 - --- - -[float] -=== http - -Fields related to HTTP activity. Use the `url` field set to store the url of the request. - - -*`http.request.body.bytes`*:: -+ --- -Size in bytes of the request body. - -type: long - -example: 887 - -format: bytes - --- - -*`http.request.body.content`*:: -+ --- -The full HTTP request body. - -type: wildcard - -example: Hello world - --- - -*`http.request.body.content.text`*:: -+ --- -type: match_only_text - --- - -*`http.request.bytes`*:: -+ --- -Total size in bytes of the request (body and headers). - -type: long - -example: 1437 - -format: bytes - --- - -*`http.request.id`*:: -+ --- -A unique identifier for each HTTP request to correlate logs between clients and servers in transactions. -The id may be contained in a non-standard HTTP header, such as `X-Request-ID` or `X-Correlation-ID`. - -type: keyword - -example: 123e4567-e89b-12d3-a456-426614174000 - --- - -*`http.request.method`*:: -+ --- -HTTP request method. -The value should retain its casing from the original event. For example, `GET`, `get`, and `GeT` are all considered valid values for this field. - -type: keyword - -example: POST - --- - -*`http.request.mime_type`*:: -+ --- -Mime type of the body of the request. -This value must only be populated based on the content of the request body, not on the `Content-Type` header. Comparing the mime type of a request with the request's Content-Type header can be helpful in detecting threats or misconfigured clients. - -type: keyword - -example: image/gif - --- - -*`http.request.referrer`*:: -+ --- -Referrer for this HTTP request. - -type: keyword - -example: https://blog.example.com/ - --- - -*`http.response.body.bytes`*:: -+ --- -Size in bytes of the response body. - -type: long - -example: 887 - -format: bytes - --- - -*`http.response.body.content`*:: -+ --- -The full HTTP response body. - -type: wildcard - -example: Hello world - --- - -*`http.response.body.content.text`*:: -+ --- -type: match_only_text - --- - -*`http.response.bytes`*:: -+ --- -Total size in bytes of the response (body and headers). - -type: long - -example: 1437 - -format: bytes - --- - -*`http.response.mime_type`*:: -+ --- -Mime type of the body of the response. -This value must only be populated based on the content of the response body, not on the `Content-Type` header. Comparing the mime type of a response with the response's Content-Type header can be helpful in detecting misconfigured servers. - -type: keyword - -example: image/gif - --- - -*`http.response.status_code`*:: -+ --- -HTTP response status code. - -type: long - -example: 404 - -format: string - --- - -*`http.version`*:: -+ --- -HTTP version. - -type: keyword - -example: 1.1 - --- - -[float] -=== interface - -The interface fields are used to record ingress and egress interface information when reported by an observer (e.g. firewall, router, load balancer) in the context of the observer handling a network connection. In the case of a single observer interface (e.g. network sensor on a span port) only the observer.ingress information should be populated. - - -*`interface.alias`*:: -+ --- -Interface alias as reported by the system, typically used in firewall implementations for e.g. inside, outside, or dmz logical interface naming. - -type: keyword - -example: outside - --- - -*`interface.id`*:: -+ --- -Interface ID as reported by an observer (typically SNMP interface ID). - -type: keyword - -example: 10 - --- - -*`interface.name`*:: -+ --- -Interface name as reported by the system. - -type: keyword - -example: eth0 - --- - -[float] -=== log - -Details about the event's logging mechanism or logging transport. -The log.* fields are typically populated with details about the logging mechanism used to create and/or transport the event. For example, syslog details belong under `log.syslog.*`. -The details specific to your event source are typically not logged under `log.*`, but rather in `event.*` or in other ECS fields. - - -*`log.file.path`*:: -+ --- -Full path to the log file this event came from, including the file name. It should include the drive letter, when appropriate. -If the event wasn't read from a log file, do not populate this field. - -type: keyword - -example: /var/log/fun-times.log - --- - -*`log.level`*:: -+ --- -Original log level of the log event. -If the source of the event provides a log level or textual severity, this is the one that goes in `log.level`. If your source doesn't specify one, you may put your event transport's severity here (e.g. Syslog severity). -Some examples are `warn`, `err`, `i`, `informational`. - -type: keyword - -example: error - --- - -*`log.logger`*:: -+ --- -The name of the logger inside an application. This is usually the name of the class which initialized the logger, or can be a custom name. - -type: keyword - -example: org.elasticsearch.bootstrap.Bootstrap - --- - -*`log.origin.file.line`*:: -+ --- -The line number of the file containing the source code which originated the log event. - -type: long - -example: 42 - --- - -*`log.origin.file.name`*:: -+ --- -The name of the file containing the source code which originated the log event. -Note that this field is not meant to capture the log file. The correct field to capture the log file is `log.file.path`. - -type: keyword - -example: Bootstrap.java - --- - -*`log.origin.function`*:: -+ --- -The name of the function or method which originated the log event. - -type: keyword - -example: init - --- - -*`log.syslog`*:: -+ --- -The Syslog metadata of the event, if the event was transmitted via Syslog. Please see RFCs 5424 or 3164. - -type: object - --- - -*`log.syslog.facility.code`*:: -+ --- -The Syslog numeric facility of the log event, if available. -According to RFCs 5424 and 3164, this value should be an integer between 0 and 23. - -type: long - -example: 23 - -format: string - --- - -*`log.syslog.facility.name`*:: -+ --- -The Syslog text-based facility of the log event, if available. - -type: keyword - -example: local7 - --- - -*`log.syslog.priority`*:: -+ --- -Syslog numeric priority of the event, if available. -According to RFCs 5424 and 3164, the priority is 8 * facility + severity. This number is therefore expected to contain a value between 0 and 191. - -type: long - -example: 135 - -format: string - --- - -*`log.syslog.severity.code`*:: -+ --- -The Syslog numeric severity of the log event, if available. -If the event source publishing via Syslog provides a different numeric severity value (e.g. firewall, IDS), your source's numeric severity should go to `event.severity`. If the event source does not specify a distinct severity, you can optionally copy the Syslog severity to `event.severity`. - -type: long - -example: 3 - --- - -*`log.syslog.severity.name`*:: -+ --- -The Syslog numeric severity of the log event, if available. -If the event source publishing via Syslog provides a different severity value (e.g. firewall, IDS), your source's text severity should go to `log.level`. If the event source does not specify a distinct severity, you can optionally copy the Syslog severity to `log.level`. - -type: keyword - -example: Error - --- - -[float] -=== network - -The network is defined as the communication path over which a host or network event happens. -The network.* fields should be populated with details about the network activity associated with an event. - - -*`network.application`*:: -+ --- -When a specific application or service is identified from network connection details (source/dest IPs, ports, certificates, or wire format), this field captures the application's or service's name. -For example, the original event identifies the network connection being from a specific web service in a `https` network connection, like `facebook` or `twitter`. -The field value must be normalized to lowercase for querying. - -type: keyword - -example: aim - --- - -*`network.bytes`*:: -+ --- -Total bytes transferred in both directions. -If `source.bytes` and `destination.bytes` are known, `network.bytes` is their sum. - -type: long - -example: 368 - -format: bytes - --- - -*`network.community_id`*:: -+ --- -A hash of source and destination IPs and ports, as well as the protocol used in a communication. This is a tool-agnostic standard to identify flows. -Learn more at https://github.com/corelight/community-id-spec. - -type: keyword - -example: 1:hO+sN4H+MG5MY/8hIrXPqc4ZQz0= - --- - -*`network.direction`*:: -+ --- -Direction of the network traffic. -Recommended values are: - * ingress - * egress - * inbound - * outbound - * internal - * external - * unknown - -When mapping events from a host-based monitoring context, populate this field from the host's point of view, using the values "ingress" or "egress". -When mapping events from a network or perimeter-based monitoring context, populate this field from the point of view of the network perimeter, using the values "inbound", "outbound", "internal" or "external". -Note that "internal" is not crossing perimeter boundaries, and is meant to describe communication between two hosts within the perimeter. Note also that "external" is meant to describe traffic between two hosts that are external to the perimeter. This could for example be useful for ISPs or VPN service providers. - -type: keyword - -example: inbound - --- - -*`network.forwarded_ip`*:: -+ --- -Host IP address when the source IP address is the proxy. - -type: ip - -example: 192.1.1.2 - --- - -*`network.iana_number`*:: -+ --- -IANA Protocol Number (https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml). Standardized list of protocols. This aligns well with NetFlow and sFlow related logs which use the IANA Protocol Number. - -type: keyword - -example: 6 - --- - -*`network.inner`*:: -+ --- -Network.inner fields are added in addition to network.vlan fields to describe the innermost VLAN when q-in-q VLAN tagging is present. Allowed fields include vlan.id and vlan.name. Inner vlan fields are typically used when sending traffic with multiple 802.1q encapsulations to a network sensor (e.g. Zeek, Wireshark.) - -type: object - --- - -*`network.inner.vlan.id`*:: -+ --- -VLAN ID as reported by the observer. - -type: keyword - -example: 10 - --- - -*`network.inner.vlan.name`*:: -+ --- -Optional VLAN name as reported by the observer. - -type: keyword - -example: outside - --- - -*`network.name`*:: -+ --- -Name given by operators to sections of their network. - -type: keyword - -example: Guest Wifi - --- - -*`network.packets`*:: -+ --- -Total packets transferred in both directions. -If `source.packets` and `destination.packets` are known, `network.packets` is their sum. - -type: long - -example: 24 - --- - -*`network.protocol`*:: -+ --- -In the OSI Model this would be the Application Layer protocol. For example, `http`, `dns`, or `ssh`. -The field value must be normalized to lowercase for querying. - -type: keyword - -example: http - --- - -*`network.transport`*:: -+ --- -Same as network.iana_number, but instead using the Keyword name of the transport layer (udp, tcp, ipv6-icmp, etc.) -The field value must be normalized to lowercase for querying. - -type: keyword - -example: tcp - --- - -*`network.type`*:: -+ --- -In the OSI Model this would be the Network Layer. ipv4, ipv6, ipsec, pim, etc -The field value must be normalized to lowercase for querying. - -type: keyword - -example: ipv4 - --- - -*`network.vlan.id`*:: -+ --- -VLAN ID as reported by the observer. - -type: keyword - -example: 10 - --- - -*`network.vlan.name`*:: -+ --- -Optional VLAN name as reported by the observer. - -type: keyword - -example: outside - --- - -[float] -=== observer - -An observer is defined as a special network, security, or application device used to detect, observe, or create network, security, or application-related events and metrics. -This could be a custom hardware appliance or a server that has been configured to run special network, security, or application software. Examples include firewalls, web proxies, intrusion detection/prevention systems, network monitoring sensors, web application firewalls, data loss prevention systems, and APM servers. The observer.* fields shall be populated with details of the system, if any, that detects, observes and/or creates a network, security, or application event or metric. Message queues and ETL components used in processing events or metrics are not considered observers in ECS. - - -*`observer.egress`*:: -+ --- -Observer.egress holds information like interface number and name, vlan, and zone information to classify egress traffic. Single armed monitoring such as a network sensor on a span port should only use observer.ingress to categorize traffic. - -type: object - --- - -*`observer.egress.interface.alias`*:: -+ --- -Interface alias as reported by the system, typically used in firewall implementations for e.g. inside, outside, or dmz logical interface naming. - -type: keyword - -example: outside - --- - -*`observer.egress.interface.id`*:: -+ --- -Interface ID as reported by an observer (typically SNMP interface ID). - -type: keyword - -example: 10 - --- - -*`observer.egress.interface.name`*:: -+ --- -Interface name as reported by the system. - -type: keyword - -example: eth0 - --- - -*`observer.egress.vlan.id`*:: -+ --- -VLAN ID as reported by the observer. - -type: keyword - -example: 10 - --- - -*`observer.egress.vlan.name`*:: -+ --- -Optional VLAN name as reported by the observer. - -type: keyword - -example: outside - --- - -*`observer.egress.zone`*:: -+ --- -Network zone of outbound traffic as reported by the observer to categorize the destination area of egress traffic, e.g. Internal, External, DMZ, HR, Legal, etc. - -type: keyword - -example: Public_Internet - --- - -*`observer.geo.city_name`*:: -+ --- -City name. - -type: keyword - -example: Montreal - --- - -*`observer.geo.continent_code`*:: -+ --- -Two-letter code representing continent's name. - -type: keyword - -example: NA - --- - -*`observer.geo.continent_name`*:: -+ --- -Name of the continent. - -type: keyword - -example: North America - --- - -*`observer.geo.country_iso_code`*:: -+ --- -Country ISO code. - -type: keyword - -example: CA - --- - -*`observer.geo.country_name`*:: -+ --- -Country name. - -type: keyword - -example: Canada - --- - -*`observer.geo.location`*:: -+ --- -Longitude and latitude. - -type: geo_point - -example: { "lon": -73.614830, "lat": 45.505918 } - --- - -*`observer.geo.name`*:: -+ --- -User-defined description of a location, at the level of granularity they care about. -Could be the name of their data centers, the floor number, if this describes a local physical entity, city names. -Not typically used in automated geolocation. - -type: keyword - -example: boston-dc - --- - -*`observer.geo.postal_code`*:: -+ --- -Postal code associated with the location. -Values appropriate for this field may also be known as a postcode or ZIP code and will vary widely from country to country. - -type: keyword - -example: 94040 - --- - -*`observer.geo.region_iso_code`*:: -+ --- -Region ISO code. - -type: keyword - -example: CA-QC - --- - -*`observer.geo.region_name`*:: -+ --- -Region name. - -type: keyword - -example: Quebec - --- - -*`observer.geo.timezone`*:: -+ --- -The time zone of the location, such as IANA time zone name. - -type: keyword - -example: America/Argentina/Buenos_Aires - --- - -*`observer.hostname`*:: -+ --- -Hostname of the observer. - -type: keyword - --- - -*`observer.ingress`*:: -+ --- -Observer.ingress holds information like interface number and name, vlan, and zone information to classify ingress traffic. Single armed monitoring such as a network sensor on a span port should only use observer.ingress to categorize traffic. - -type: object - --- - -*`observer.ingress.interface.alias`*:: -+ --- -Interface alias as reported by the system, typically used in firewall implementations for e.g. inside, outside, or dmz logical interface naming. - -type: keyword - -example: outside - --- - -*`observer.ingress.interface.id`*:: -+ --- -Interface ID as reported by an observer (typically SNMP interface ID). - -type: keyword - -example: 10 - --- - -*`observer.ingress.interface.name`*:: -+ --- -Interface name as reported by the system. - -type: keyword - -example: eth0 - --- - -*`observer.ingress.vlan.id`*:: -+ --- -VLAN ID as reported by the observer. - -type: keyword - -example: 10 - --- - -*`observer.ingress.vlan.name`*:: -+ --- -Optional VLAN name as reported by the observer. - -type: keyword - -example: outside - --- - -*`observer.ingress.zone`*:: -+ --- -Network zone of incoming traffic as reported by the observer to categorize the source area of ingress traffic. e.g. internal, External, DMZ, HR, Legal, etc. - -type: keyword - -example: DMZ - --- - -*`observer.ip`*:: -+ --- -IP addresses of the observer. - -type: ip - --- - -*`observer.mac`*:: -+ --- -MAC addresses of the observer. -The notation format from RFC 7042 is suggested: Each octet (that is, 8-bit byte) is represented by two [uppercase] hexadecimal digits giving the value of the octet as an unsigned integer. Successive octets are separated by a hyphen. - -type: keyword - -example: ["00-00-5E-00-53-23", "00-00-5E-00-53-24"] - --- - -*`observer.name`*:: -+ --- -Custom name of the observer. -This is a name that can be given to an observer. This can be helpful for example if multiple firewalls of the same model are used in an organization. -If no custom name is needed, the field can be left empty. - -type: keyword - -example: 1_proxySG - --- - -*`observer.os.family`*:: -+ --- -OS family (such as redhat, debian, freebsd, windows). - -type: keyword - -example: debian - --- - -*`observer.os.full`*:: -+ --- -Operating system name, including the version or code name. - -type: keyword - -example: Mac OS Mojave - --- - -*`observer.os.full.text`*:: -+ --- -type: match_only_text - --- - -*`observer.os.kernel`*:: -+ --- -Operating system kernel version as a raw string. - -type: keyword - -example: 4.4.0-112-generic - --- - -*`observer.os.name`*:: -+ --- -Operating system name, without the version. - -type: keyword - -example: Mac OS X - --- - -*`observer.os.name.text`*:: -+ --- -type: match_only_text - --- - -*`observer.os.platform`*:: -+ --- -Operating system platform (such centos, ubuntu, windows). - -type: keyword - -example: darwin - --- - -*`observer.os.type`*:: -+ --- -Use the `os.type` field to categorize the operating system into one of the broad commercial families. -One of these following values should be used (lowercase): linux, macos, unix, windows. -If the OS you're dealing with is not in the list, the field should not be populated. Please let us know by opening an issue with ECS, to propose its addition. - -type: keyword - -example: macos - --- - -*`observer.os.version`*:: -+ --- -Operating system version as a raw string. - -type: keyword - -example: 10.14.1 - --- - -*`observer.product`*:: -+ --- -The product name of the observer. - -type: keyword - -example: s200 - --- - -*`observer.serial_number`*:: -+ --- -Observer serial number. - -type: keyword - --- - -*`observer.type`*:: -+ --- -The type of the observer the data is coming from. -There is no predefined list of observer types. Some examples are `forwarder`, `firewall`, `ids`, `ips`, `proxy`, `poller`, `sensor`, `APM server`. - -type: keyword - -example: firewall - --- - -*`observer.vendor`*:: -+ --- -Vendor name of the observer. - -type: keyword - -example: Symantec - --- - -*`observer.version`*:: -+ --- -Observer version. - -type: keyword - --- - -[float] -=== orchestrator - -Fields that describe the resources which container orchestrators manage or act upon. - - -*`orchestrator.api_version`*:: -+ --- -API version being used to carry out the action - -type: keyword - -example: v1beta1 - --- - -*`orchestrator.cluster.name`*:: -+ --- -Name of the cluster. - -type: keyword - --- - -*`orchestrator.cluster.url`*:: -+ --- -URL of the API used to manage the cluster. - -type: keyword - --- - -*`orchestrator.cluster.version`*:: -+ --- -The version of the cluster. - -type: keyword - --- - -*`orchestrator.namespace`*:: -+ --- -Namespace in which the action is taking place. - -type: keyword - -example: kube-system - --- - -*`orchestrator.organization`*:: -+ --- -Organization affected by the event (for multi-tenant orchestrator setups). - -type: keyword - -example: elastic - --- - -*`orchestrator.resource.name`*:: -+ --- -Name of the resource being acted upon. - -type: keyword - -example: test-pod-cdcws - --- - -*`orchestrator.resource.type`*:: -+ --- -Type of resource being acted upon. - -type: keyword - -example: service - --- - -*`orchestrator.type`*:: -+ --- -Orchestrator cluster type (e.g. kubernetes, nomad or cloudfoundry). - -type: keyword - -example: kubernetes - --- - -[float] -=== organization - -The organization fields enrich data with information about the company or entity the data is associated with. -These fields help you arrange or filter data stored in an index by one or multiple organizations. - - -*`organization.id`*:: -+ --- -Unique identifier for the organization. - -type: keyword - --- - -*`organization.name`*:: -+ --- -Organization name. - -type: keyword - --- - -*`organization.name.text`*:: -+ --- -type: match_only_text - --- - -[float] -=== os - -The OS fields contain information about the operating system. - - -*`os.family`*:: -+ --- -OS family (such as redhat, debian, freebsd, windows). - -type: keyword - -example: debian - --- - -*`os.full`*:: -+ --- -Operating system name, including the version or code name. - -type: keyword - -example: Mac OS Mojave - --- - -*`os.full.text`*:: -+ --- -type: match_only_text - --- - -*`os.kernel`*:: -+ --- -Operating system kernel version as a raw string. - -type: keyword - -example: 4.4.0-112-generic - --- - -*`os.name`*:: -+ --- -Operating system name, without the version. - -type: keyword - -example: Mac OS X - --- - -*`os.name.text`*:: -+ --- -type: match_only_text - --- - -*`os.platform`*:: -+ --- -Operating system platform (such centos, ubuntu, windows). - -type: keyword - -example: darwin - --- - -*`os.type`*:: -+ --- -Use the `os.type` field to categorize the operating system into one of the broad commercial families. -One of these following values should be used (lowercase): linux, macos, unix, windows. -If the OS you're dealing with is not in the list, the field should not be populated. Please let us know by opening an issue with ECS, to propose its addition. - -type: keyword - -example: macos - --- - -*`os.version`*:: -+ --- -Operating system version as a raw string. - -type: keyword - -example: 10.14.1 - --- - -[float] -=== package - -These fields contain information about an installed software package. It contains general information about a package, such as name, version or size. It also contains installation details, such as time or location. - - -*`package.architecture`*:: -+ --- -Package architecture. - -type: keyword - -example: x86_64 - --- - -*`package.build_version`*:: -+ --- -Additional information about the build version of the installed package. -For example use the commit SHA of a non-released package. - -type: keyword - -example: 36f4f7e89dd61b0988b12ee000b98966867710cd - --- - -*`package.checksum`*:: -+ --- -Checksum of the installed package for verification. - -type: keyword - -example: 68b329da9893e34099c7d8ad5cb9c940 - --- - -*`package.description`*:: -+ --- -Description of the package. - -type: keyword - -example: Open source programming language to build simple/reliable/efficient software. - --- - -*`package.install_scope`*:: -+ --- -Indicating how the package was installed, e.g. user-local, global. - -type: keyword - -example: global - --- - -*`package.installed`*:: -+ --- -Time when package was installed. - -type: date - --- - -*`package.license`*:: -+ --- -License under which the package was released. -Use a short name, e.g. the license identifier from SPDX License List where possible (https://spdx.org/licenses/). - -type: keyword - -example: Apache License 2.0 - --- - -*`package.name`*:: -+ --- -Package name - -type: keyword - -example: go - --- - -*`package.path`*:: -+ --- -Path where the package is installed. - -type: keyword - -example: /usr/local/Cellar/go/1.12.9/ - --- - -*`package.reference`*:: -+ --- -Home page or reference URL of the software in this package, if available. - -type: keyword - -example: https://golang.org - --- - -*`package.size`*:: -+ --- -Package size in bytes. - -type: long - -example: 62231 - -format: string - --- - -*`package.type`*:: -+ --- -Type of package. -This should contain the package file type, rather than the package manager name. Examples: rpm, dpkg, brew, npm, gem, nupkg, jar. - -type: keyword - -example: rpm - --- - -*`package.version`*:: -+ --- -Package version - -type: keyword - -example: 1.12.9 - --- - -[float] -=== pe - -These fields contain Windows Portable Executable (PE) metadata. - - -*`pe.architecture`*:: -+ --- -CPU architecture target for the file. - -type: keyword - -example: x64 - --- - -*`pe.company`*:: -+ --- -Internal company name of the file, provided at compile-time. - -type: keyword - -example: Microsoft Corporation - --- - -*`pe.description`*:: -+ --- -Internal description of the file, provided at compile-time. - -type: keyword - -example: Paint - --- - -*`pe.file_version`*:: -+ --- -Internal version of the file, provided at compile-time. - -type: keyword - -example: 6.3.9600.17415 - --- - -*`pe.imphash`*:: -+ --- -A hash of the imports in a PE file. An imphash -- or import hash -- can be used to fingerprint binaries even after recompilation or other code-level transformations have occurred, which would change more traditional hash values. -Learn more at https://www.fireeye.com/blog/threat-research/2014/01/tracking-malware-import-hashing.html. - -type: keyword - -example: 0c6803c4e922103c4dca5963aad36ddf - --- - -*`pe.original_file_name`*:: -+ --- -Internal name of the file, provided at compile-time. - -type: keyword - -example: MSPAINT.EXE - --- - -*`pe.product`*:: -+ --- -Internal product name of the file, provided at compile-time. - -type: keyword - -example: Microsoft® Windows® Operating System - --- - -[float] -=== process - -These fields contain information about a process. -These fields can help you correlate metrics information with a process id/name from a log message. The `process.pid` often stays in the metric itself and is copied to the global field for correlation. - - -*`process.args`*:: -+ --- -Array of process arguments, starting with the absolute path to the executable. -May be filtered to protect sensitive information. - -type: keyword - -example: ["/usr/bin/ssh", "-l", "user", "10.0.0.16"] - --- - -*`process.args_count`*:: -+ --- -Length of the process.args array. -This field can be useful for querying or performing bucket analysis on how many arguments were provided to start a process. More arguments may be an indication of suspicious activity. - -type: long - -example: 4 - --- - -*`process.code_signature.digest_algorithm`*:: -+ --- -The hashing algorithm used to sign the process. -This value can distinguish signatures when a file is signed multiple times by the same signer but with a different digest algorithm. - -type: keyword - -example: sha256 - --- - -*`process.code_signature.exists`*:: -+ --- -Boolean to capture if a signature is present. - -type: boolean - -example: true - --- - -*`process.code_signature.signing_id`*:: -+ --- -The identifier used to sign the process. -This is used to identify the application manufactured by a software vendor. The field is relevant to Apple *OS only. - -type: keyword - -example: com.apple.xpc.proxy - --- - -*`process.code_signature.status`*:: -+ --- -Additional information about the certificate status. -This is useful for logging cryptographic errors with the certificate validity or trust status. Leave unpopulated if the validity or trust of the certificate was unchecked. - -type: keyword - -example: ERROR_UNTRUSTED_ROOT - --- - -*`process.code_signature.subject_name`*:: -+ --- -Subject name of the code signer - -type: keyword - -example: Microsoft Corporation - --- - -*`process.code_signature.team_id`*:: -+ --- -The team identifier used to sign the process. -This is used to identify the team or vendor of a software product. The field is relevant to Apple *OS only. - -type: keyword - -example: EQHXZ8M8AV - --- - -*`process.code_signature.timestamp`*:: -+ --- -Date and time when the code signature was generated and signed. - -type: date - -example: 2021-01-01T12:10:30Z - --- - -*`process.code_signature.trusted`*:: -+ --- -Stores the trust status of the certificate chain. -Validating the trust of the certificate chain may be complicated, and this field should only be populated by tools that actively check the status. - -type: boolean - -example: true - --- - -*`process.code_signature.valid`*:: -+ --- -Boolean to capture if the digital signature is verified against the binary content. -Leave unpopulated if a certificate was unchecked. - -type: boolean - -example: true - --- - -*`process.command_line`*:: -+ --- -Full command line that started the process, including the absolute path to the executable, and all arguments. -Some arguments may be filtered to protect sensitive information. - -type: wildcard - -example: /usr/bin/ssh -l user 10.0.0.16 - --- - -*`process.command_line.text`*:: -+ --- -type: match_only_text - --- - -*`process.elf.architecture`*:: -+ --- -Machine architecture of the ELF file. - -type: keyword - -example: x86-64 - --- - -*`process.elf.byte_order`*:: -+ --- -Byte sequence of ELF file. - -type: keyword - -example: Little Endian - --- - -*`process.elf.cpu_type`*:: -+ --- -CPU type of the ELF file. - -type: keyword - -example: Intel - --- - -*`process.elf.creation_date`*:: -+ --- -Extracted when possible from the file's metadata. Indicates when it was built or compiled. It can also be faked by malware creators. - -type: date - --- - -*`process.elf.exports`*:: -+ --- -List of exported element names and types. - -type: flattened - --- - -*`process.elf.header.abi_version`*:: -+ --- -Version of the ELF Application Binary Interface (ABI). - -type: keyword - --- - -*`process.elf.header.class`*:: -+ --- -Header class of the ELF file. - -type: keyword - --- - -*`process.elf.header.data`*:: -+ --- -Data table of the ELF header. - -type: keyword - --- - -*`process.elf.header.entrypoint`*:: -+ --- -Header entrypoint of the ELF file. - -type: long - -format: string - --- - -*`process.elf.header.object_version`*:: -+ --- -"0x1" for original ELF files. - -type: keyword - --- - -*`process.elf.header.os_abi`*:: -+ --- -Application Binary Interface (ABI) of the Linux OS. - -type: keyword - --- - -*`process.elf.header.type`*:: -+ --- -Header type of the ELF file. - -type: keyword - --- - -*`process.elf.header.version`*:: -+ --- -Version of the ELF header. - -type: keyword - --- - -*`process.elf.imports`*:: -+ --- -List of imported element names and types. - -type: flattened - --- - -*`process.elf.sections`*:: -+ --- -An array containing an object for each section of the ELF file. -The keys that should be present in these objects are defined by sub-fields underneath `elf.sections.*`. - -type: nested - --- - -*`process.elf.sections.chi2`*:: -+ --- -Chi-square probability distribution of the section. - -type: long - -format: number - --- - -*`process.elf.sections.entropy`*:: -+ --- -Shannon entropy calculation from the section. - -type: long - -format: number - --- - -*`process.elf.sections.flags`*:: -+ --- -ELF Section List flags. - -type: keyword - --- - -*`process.elf.sections.name`*:: -+ --- -ELF Section List name. - -type: keyword - --- - -*`process.elf.sections.physical_offset`*:: -+ --- -ELF Section List offset. - -type: keyword - --- - -*`process.elf.sections.physical_size`*:: -+ --- -ELF Section List physical size. - -type: long - -format: bytes - --- - -*`process.elf.sections.type`*:: -+ --- -ELF Section List type. - -type: keyword - --- - -*`process.elf.sections.virtual_address`*:: -+ --- -ELF Section List virtual address. - -type: long - -format: string - --- - -*`process.elf.sections.virtual_size`*:: -+ --- -ELF Section List virtual size. - -type: long - -format: string - --- - -*`process.elf.segments`*:: -+ --- -An array containing an object for each segment of the ELF file. -The keys that should be present in these objects are defined by sub-fields underneath `elf.segments.*`. - -type: nested - --- - -*`process.elf.segments.sections`*:: -+ --- -ELF object segment sections. - -type: keyword - --- - -*`process.elf.segments.type`*:: -+ --- -ELF object segment type. - -type: keyword - --- - -*`process.elf.shared_libraries`*:: -+ --- -List of shared libraries used by this ELF object. - -type: keyword - --- - -*`process.elf.telfhash`*:: -+ --- -telfhash symbol hash for ELF file. - -type: keyword - --- - -*`process.end`*:: -+ --- -The time the process ended. - -type: date - -example: 2016-05-23T08:05:34.853Z - --- - -*`process.entity_id`*:: -+ --- -Unique identifier for the process. -The implementation of this is specified by the data source, but some examples of what could be used here are a process-generated UUID, Sysmon Process GUIDs, or a hash of some uniquely identifying components of a process. -Constructing a globally unique identifier is a common practice to mitigate PID reuse as well as to identify a specific process over time, across multiple monitored hosts. - -type: keyword - -example: c2c455d9f99375d - --- - -*`process.executable`*:: -+ --- -Absolute path to the process executable. - -type: keyword - -example: /usr/bin/ssh - --- - -*`process.executable.text`*:: -+ --- -type: match_only_text - --- - -*`process.exit_code`*:: -+ --- -The exit code of the process, if this is a termination event. -The field should be absent if there is no exit code for the event (e.g. process start). - -type: long - -example: 137 - --- - -*`process.hash.md5`*:: -+ --- -MD5 hash. - -type: keyword - --- - -*`process.hash.sha1`*:: -+ --- -SHA1 hash. - -type: keyword - --- - -*`process.hash.sha256`*:: -+ --- -SHA256 hash. - -type: keyword - --- - -*`process.hash.sha512`*:: -+ --- -SHA512 hash. - -type: keyword - --- - -*`process.hash.ssdeep`*:: -+ --- -SSDEEP hash. - -type: keyword - --- - -*`process.name`*:: -+ --- -Process name. -Sometimes called program name or similar. - -type: keyword - -example: ssh - --- - -*`process.name.text`*:: -+ --- -type: match_only_text - --- - -*`process.parent.args`*:: -+ --- -Array of process arguments, starting with the absolute path to the executable. -May be filtered to protect sensitive information. - -type: keyword - -example: ["/usr/bin/ssh", "-l", "user", "10.0.0.16"] - --- - -*`process.parent.args_count`*:: -+ --- -Length of the process.args array. -This field can be useful for querying or performing bucket analysis on how many arguments were provided to start a process. More arguments may be an indication of suspicious activity. - -type: long - -example: 4 - --- - -*`process.parent.code_signature.digest_algorithm`*:: -+ --- -The hashing algorithm used to sign the process. -This value can distinguish signatures when a file is signed multiple times by the same signer but with a different digest algorithm. - -type: keyword - -example: sha256 - --- - -*`process.parent.code_signature.exists`*:: -+ --- -Boolean to capture if a signature is present. - -type: boolean - -example: true - --- - -*`process.parent.code_signature.signing_id`*:: -+ --- -The identifier used to sign the process. -This is used to identify the application manufactured by a software vendor. The field is relevant to Apple *OS only. - -type: keyword - -example: com.apple.xpc.proxy - --- - -*`process.parent.code_signature.status`*:: -+ --- -Additional information about the certificate status. -This is useful for logging cryptographic errors with the certificate validity or trust status. Leave unpopulated if the validity or trust of the certificate was unchecked. - -type: keyword - -example: ERROR_UNTRUSTED_ROOT - --- - -*`process.parent.code_signature.subject_name`*:: -+ --- -Subject name of the code signer - -type: keyword - -example: Microsoft Corporation - --- - -*`process.parent.code_signature.team_id`*:: -+ --- -The team identifier used to sign the process. -This is used to identify the team or vendor of a software product. The field is relevant to Apple *OS only. - -type: keyword - -example: EQHXZ8M8AV - --- - -*`process.parent.code_signature.timestamp`*:: -+ --- -Date and time when the code signature was generated and signed. - -type: date - -example: 2021-01-01T12:10:30Z - --- - -*`process.parent.code_signature.trusted`*:: -+ --- -Stores the trust status of the certificate chain. -Validating the trust of the certificate chain may be complicated, and this field should only be populated by tools that actively check the status. - -type: boolean - -example: true - --- - -*`process.parent.code_signature.valid`*:: -+ --- -Boolean to capture if the digital signature is verified against the binary content. -Leave unpopulated if a certificate was unchecked. - -type: boolean - -example: true - --- - -*`process.parent.command_line`*:: -+ --- -Full command line that started the process, including the absolute path to the executable, and all arguments. -Some arguments may be filtered to protect sensitive information. - -type: wildcard - -example: /usr/bin/ssh -l user 10.0.0.16 - --- - -*`process.parent.command_line.text`*:: -+ --- -type: match_only_text - --- - -*`process.parent.elf.architecture`*:: -+ --- -Machine architecture of the ELF file. - -type: keyword - -example: x86-64 - --- - -*`process.parent.elf.byte_order`*:: -+ --- -Byte sequence of ELF file. - -type: keyword - -example: Little Endian - --- - -*`process.parent.elf.cpu_type`*:: -+ --- -CPU type of the ELF file. - -type: keyword - -example: Intel - --- - -*`process.parent.elf.creation_date`*:: -+ --- -Extracted when possible from the file's metadata. Indicates when it was built or compiled. It can also be faked by malware creators. - -type: date - --- - -*`process.parent.elf.exports`*:: -+ --- -List of exported element names and types. - -type: flattened - --- - -*`process.parent.elf.header.abi_version`*:: -+ --- -Version of the ELF Application Binary Interface (ABI). - -type: keyword - --- - -*`process.parent.elf.header.class`*:: -+ --- -Header class of the ELF file. - -type: keyword - --- - -*`process.parent.elf.header.data`*:: -+ --- -Data table of the ELF header. - -type: keyword - --- - -*`process.parent.elf.header.entrypoint`*:: -+ --- -Header entrypoint of the ELF file. - -type: long - -format: string - --- - -*`process.parent.elf.header.object_version`*:: -+ --- -"0x1" for original ELF files. - -type: keyword - --- - -*`process.parent.elf.header.os_abi`*:: -+ --- -Application Binary Interface (ABI) of the Linux OS. - -type: keyword - --- - -*`process.parent.elf.header.type`*:: -+ --- -Header type of the ELF file. - -type: keyword - --- - -*`process.parent.elf.header.version`*:: -+ --- -Version of the ELF header. - -type: keyword - --- - -*`process.parent.elf.imports`*:: -+ --- -List of imported element names and types. - -type: flattened - --- - -*`process.parent.elf.sections`*:: -+ --- -An array containing an object for each section of the ELF file. -The keys that should be present in these objects are defined by sub-fields underneath `elf.sections.*`. - -type: nested - --- - -*`process.parent.elf.sections.chi2`*:: -+ --- -Chi-square probability distribution of the section. - -type: long - -format: number - --- - -*`process.parent.elf.sections.entropy`*:: -+ --- -Shannon entropy calculation from the section. - -type: long - -format: number - --- - -*`process.parent.elf.sections.flags`*:: -+ --- -ELF Section List flags. - -type: keyword - --- - -*`process.parent.elf.sections.name`*:: -+ --- -ELF Section List name. - -type: keyword - --- - -*`process.parent.elf.sections.physical_offset`*:: -+ --- -ELF Section List offset. - -type: keyword - --- - -*`process.parent.elf.sections.physical_size`*:: -+ --- -ELF Section List physical size. - -type: long - -format: bytes - --- - -*`process.parent.elf.sections.type`*:: -+ --- -ELF Section List type. - -type: keyword - --- - -*`process.parent.elf.sections.virtual_address`*:: -+ --- -ELF Section List virtual address. - -type: long - -format: string - --- - -*`process.parent.elf.sections.virtual_size`*:: -+ --- -ELF Section List virtual size. - -type: long - -format: string - --- - -*`process.parent.elf.segments`*:: -+ --- -An array containing an object for each segment of the ELF file. -The keys that should be present in these objects are defined by sub-fields underneath `elf.segments.*`. - -type: nested - --- - -*`process.parent.elf.segments.sections`*:: -+ --- -ELF object segment sections. - -type: keyword - --- - -*`process.parent.elf.segments.type`*:: -+ --- -ELF object segment type. - -type: keyword - --- - -*`process.parent.elf.shared_libraries`*:: -+ --- -List of shared libraries used by this ELF object. - -type: keyword - --- - -*`process.parent.elf.telfhash`*:: -+ --- -telfhash symbol hash for ELF file. - -type: keyword - --- - -*`process.parent.end`*:: -+ --- -The time the process ended. - -type: date - -example: 2016-05-23T08:05:34.853Z - --- - -*`process.parent.entity_id`*:: -+ --- -Unique identifier for the process. -The implementation of this is specified by the data source, but some examples of what could be used here are a process-generated UUID, Sysmon Process GUIDs, or a hash of some uniquely identifying components of a process. -Constructing a globally unique identifier is a common practice to mitigate PID reuse as well as to identify a specific process over time, across multiple monitored hosts. - -type: keyword - -example: c2c455d9f99375d - --- - -*`process.parent.executable`*:: -+ --- -Absolute path to the process executable. - -type: keyword - -example: /usr/bin/ssh - --- - -*`process.parent.executable.text`*:: -+ --- -type: match_only_text - --- - -*`process.parent.exit_code`*:: -+ --- -The exit code of the process, if this is a termination event. -The field should be absent if there is no exit code for the event (e.g. process start). - -type: long - -example: 137 - --- - -*`process.parent.hash.md5`*:: -+ --- -MD5 hash. - -type: keyword - --- - -*`process.parent.hash.sha1`*:: -+ --- -SHA1 hash. - -type: keyword - --- - -*`process.parent.hash.sha256`*:: -+ --- -SHA256 hash. - -type: keyword - --- - -*`process.parent.hash.sha512`*:: -+ --- -SHA512 hash. - -type: keyword - --- - -*`process.parent.hash.ssdeep`*:: -+ --- -SSDEEP hash. - -type: keyword - --- - -*`process.parent.name`*:: -+ --- -Process name. -Sometimes called program name or similar. - -type: keyword - -example: ssh - --- - -*`process.parent.name.text`*:: -+ --- -type: match_only_text - --- - -*`process.parent.pe.architecture`*:: -+ --- -CPU architecture target for the file. - -type: keyword - -example: x64 - --- - -*`process.parent.pe.company`*:: -+ --- -Internal company name of the file, provided at compile-time. - -type: keyword - -example: Microsoft Corporation - --- - -*`process.parent.pe.description`*:: -+ --- -Internal description of the file, provided at compile-time. - -type: keyword - -example: Paint - --- - -*`process.parent.pe.file_version`*:: -+ --- -Internal version of the file, provided at compile-time. - -type: keyword - -example: 6.3.9600.17415 - --- - -*`process.parent.pe.imphash`*:: -+ --- -A hash of the imports in a PE file. An imphash -- or import hash -- can be used to fingerprint binaries even after recompilation or other code-level transformations have occurred, which would change more traditional hash values. -Learn more at https://www.fireeye.com/blog/threat-research/2014/01/tracking-malware-import-hashing.html. - -type: keyword - -example: 0c6803c4e922103c4dca5963aad36ddf - --- - -*`process.parent.pe.original_file_name`*:: -+ --- -Internal name of the file, provided at compile-time. - -type: keyword - -example: MSPAINT.EXE - --- - -*`process.parent.pe.product`*:: -+ --- -Internal product name of the file, provided at compile-time. - -type: keyword - -example: Microsoft® Windows® Operating System - --- - -*`process.parent.pgid`*:: -+ --- -Identifier of the group of processes the process belongs to. - -type: long - -format: string - --- - -*`process.parent.pid`*:: -+ --- -Process id. - -type: long - -example: 4242 - -format: string - --- - -*`process.parent.start`*:: -+ --- -The time the process started. - -type: date - -example: 2016-05-23T08:05:34.853Z - --- - -*`process.parent.thread.id`*:: -+ --- -Thread ID. - -type: long - -example: 4242 - -format: string - --- - -*`process.parent.thread.name`*:: -+ --- -Thread name. - -type: keyword - -example: thread-0 - --- - -*`process.parent.title`*:: -+ --- -Process title. -The proctitle, some times the same as process name. Can also be different: for example a browser setting its title to the web page currently opened. - -type: keyword - --- - -*`process.parent.title.text`*:: -+ --- -type: match_only_text - --- - -*`process.parent.uptime`*:: -+ --- -Seconds the process has been up. - -type: long - -example: 1325 - --- - -*`process.parent.working_directory`*:: -+ --- -The working directory of the process. - -type: keyword - -example: /home/alice - --- - -*`process.parent.working_directory.text`*:: -+ --- -type: match_only_text - --- - -*`process.pe.architecture`*:: -+ --- -CPU architecture target for the file. - -type: keyword - -example: x64 - --- - -*`process.pe.company`*:: -+ --- -Internal company name of the file, provided at compile-time. - -type: keyword - -example: Microsoft Corporation - --- - -*`process.pe.description`*:: -+ --- -Internal description of the file, provided at compile-time. - -type: keyword - -example: Paint - --- - -*`process.pe.file_version`*:: -+ --- -Internal version of the file, provided at compile-time. - -type: keyword - -example: 6.3.9600.17415 - --- - -*`process.pe.imphash`*:: -+ --- -A hash of the imports in a PE file. An imphash -- or import hash -- can be used to fingerprint binaries even after recompilation or other code-level transformations have occurred, which would change more traditional hash values. -Learn more at https://www.fireeye.com/blog/threat-research/2014/01/tracking-malware-import-hashing.html. - -type: keyword - -example: 0c6803c4e922103c4dca5963aad36ddf - --- - -*`process.pe.original_file_name`*:: -+ --- -Internal name of the file, provided at compile-time. - -type: keyword - -example: MSPAINT.EXE - --- - -*`process.pe.product`*:: -+ --- -Internal product name of the file, provided at compile-time. - -type: keyword - -example: Microsoft® Windows® Operating System - --- - -*`process.pgid`*:: -+ --- -Identifier of the group of processes the process belongs to. - -type: long - -format: string - --- - -*`process.pid`*:: -+ --- -Process id. - -type: long - -example: 4242 - -format: string - --- - -*`process.start`*:: -+ --- -The time the process started. - -type: date - -example: 2016-05-23T08:05:34.853Z - --- - -*`process.thread.id`*:: -+ --- -Thread ID. - -type: long - -example: 4242 - -format: string - --- - -*`process.thread.name`*:: -+ --- -Thread name. - -type: keyword - -example: thread-0 - --- - -*`process.title`*:: -+ --- -Process title. -The proctitle, some times the same as process name. Can also be different: for example a browser setting its title to the web page currently opened. - -type: keyword - --- - -*`process.title.text`*:: -+ --- -type: match_only_text - --- - -*`process.uptime`*:: -+ --- -Seconds the process has been up. - -type: long - -example: 1325 - --- - -*`process.working_directory`*:: -+ --- -The working directory of the process. - -type: keyword - -example: /home/alice - --- - -*`process.working_directory.text`*:: -+ --- -type: match_only_text - --- - -[float] -=== registry - -Fields related to Windows Registry operations. - - -*`registry.data.bytes`*:: -+ --- -Original bytes written with base64 encoding. -For Windows registry operations, such as SetValueEx and RegQueryValueEx, this corresponds to the data pointed by `lp_data`. This is optional but provides better recoverability and should be populated for REG_BINARY encoded values. - -type: keyword - -example: ZQBuAC0AVQBTAAAAZQBuAAAAAAA= - --- - -*`registry.data.strings`*:: -+ --- -Content when writing string types. -Populated as an array when writing string data to the registry. For single string registry types (REG_SZ, REG_EXPAND_SZ), this should be an array with one string. For sequences of string with REG_MULTI_SZ, this array will be variable length. For numeric data, such as REG_DWORD and REG_QWORD, this should be populated with the decimal representation (e.g `"1"`). - -type: wildcard - -example: ["C:\rta\red_ttp\bin\myapp.exe"] - --- - -*`registry.data.type`*:: -+ --- -Standard registry type for encoding contents - -type: keyword - -example: REG_SZ - --- - -*`registry.hive`*:: -+ --- -Abbreviated name for the hive. - -type: keyword - -example: HKLM - --- - -*`registry.key`*:: -+ --- -Hive-relative path of keys. - -type: keyword - -example: SOFTWARE\Microsoft\Windows NT\CurrentVersion\Image File Execution Options\winword.exe - --- - -*`registry.path`*:: -+ --- -Full path, including hive, key and value - -type: keyword - -example: HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Image File Execution Options\winword.exe\Debugger - --- - -*`registry.value`*:: -+ --- -Name of the value written. - -type: keyword - -example: Debugger - --- - -[float] -=== related - -This field set is meant to facilitate pivoting around a piece of data. -Some pieces of information can be seen in many places in an ECS event. To facilitate searching for them, store an array of all seen values to their corresponding field in `related.`. -A concrete example is IP addresses, which can be under host, observer, source, destination, client, server, and network.forwarded_ip. If you append all IPs to `related.ip`, you can then search for a given IP trivially, no matter where it appeared, by querying `related.ip:192.0.2.15`. - - -*`related.hash`*:: -+ --- -All the hashes seen on your event. Populating this field, then using it to search for hashes can help in situations where you're unsure what the hash algorithm is (and therefore which key name to search). - -type: keyword - --- - -*`related.hosts`*:: -+ --- -All hostnames or other host identifiers seen on your event. Example identifiers include FQDNs, domain names, workstation names, or aliases. - -type: keyword - --- - -*`related.ip`*:: -+ --- -All of the IPs seen on your event. - -type: ip - --- - -*`related.user`*:: -+ --- -All the user names or other user identifiers seen on the event. - -type: keyword - --- - -[float] -=== rule - -Rule fields are used to capture the specifics of any observer or agent rules that generate alerts or other notable events. -Examples of data sources that would populate the rule fields include: network admission control platforms, network or host IDS/IPS, network firewalls, web application firewalls, url filters, endpoint detection and response (EDR) systems, etc. - - -*`rule.author`*:: -+ --- -Name, organization, or pseudonym of the author or authors who created the rule used to generate this event. - -type: keyword - -example: ["Star-Lord"] - --- - -*`rule.category`*:: -+ --- -A categorization value keyword used by the entity using the rule for detection of this event. - -type: keyword - -example: Attempted Information Leak - --- - -*`rule.description`*:: -+ --- -The description of the rule generating the event. - -type: keyword - -example: Block requests to public DNS over HTTPS / TLS protocols - --- - -*`rule.id`*:: -+ --- -A rule ID that is unique within the scope of an agent, observer, or other entity using the rule for detection of this event. - -type: keyword - -example: 101 - --- - -*`rule.license`*:: -+ --- -Name of the license under which the rule used to generate this event is made available. - -type: keyword - -example: Apache 2.0 - --- - -*`rule.name`*:: -+ --- -The name of the rule or signature generating the event. - -type: keyword - -example: BLOCK_DNS_over_TLS - --- - -*`rule.reference`*:: -+ --- -Reference URL to additional information about the rule used to generate this event. -The URL can point to the vendor's documentation about the rule. If that's not available, it can also be a link to a more general page describing this type of alert. - -type: keyword - -example: https://en.wikipedia.org/wiki/DNS_over_TLS - --- - -*`rule.ruleset`*:: -+ --- -Name of the ruleset, policy, group, or parent category in which the rule used to generate this event is a member. - -type: keyword - -example: Standard_Protocol_Filters - --- - -*`rule.uuid`*:: -+ --- -A rule ID that is unique within the scope of a set or group of agents, observers, or other entities using the rule for detection of this event. - -type: keyword - -example: 1100110011 - --- - -*`rule.version`*:: -+ --- -The version / revision of the rule being used for analysis. - -type: keyword - -example: 1.1 - --- - -[float] -=== server - -A Server is defined as the responder in a network connection for events regarding sessions, connections, or bidirectional flow records. -For TCP events, the server is the receiver of the initial SYN packet(s) of the TCP connection. For other protocols, the server is generally the responder in the network transaction. Some systems actually use the term "responder" to refer the server in TCP connections. The server fields describe details about the system acting as the server in the network event. Server fields are usually populated in conjunction with client fields. Server fields are generally not populated for packet-level events. -Client / server representations can add semantic context to an exchange, which is helpful to visualize the data in certain situations. If your context falls in that category, you should still ensure that source and destination are filled appropriately. - - -*`server.address`*:: -+ --- -Some event server addresses are defined ambiguously. The event will sometimes list an IP, a domain or a unix socket. You should always store the raw address in the `.address` field. -Then it should be duplicated to `.ip` or `.domain`, depending on which one it is. - -type: keyword - --- - -*`server.as.number`*:: -+ --- -Unique number allocated to the autonomous system. The autonomous system number (ASN) uniquely identifies each network on the Internet. - -type: long - -example: 15169 - --- - -*`server.as.organization.name`*:: -+ --- -Organization name. - -type: keyword - -example: Google LLC - --- - -*`server.as.organization.name.text`*:: -+ --- -type: match_only_text - --- - -*`server.bytes`*:: -+ --- -Bytes sent from the server to the client. - -type: long - -example: 184 - -format: bytes - --- - -*`server.domain`*:: -+ --- -The domain name of the server system. -This value may be a host name, a fully qualified domain name, or another host naming format. The value may derive from the original event or be added from enrichment. - -type: keyword - -example: foo.example.com - --- - -*`server.geo.city_name`*:: -+ --- -City name. - -type: keyword - -example: Montreal - --- - -*`server.geo.continent_code`*:: -+ --- -Two-letter code representing continent's name. - -type: keyword - -example: NA - --- - -*`server.geo.continent_name`*:: -+ --- -Name of the continent. - -type: keyword - -example: North America - --- - -*`server.geo.country_iso_code`*:: -+ --- -Country ISO code. - -type: keyword - -example: CA - --- - -*`server.geo.country_name`*:: -+ --- -Country name. - -type: keyword - -example: Canada - --- - -*`server.geo.location`*:: -+ --- -Longitude and latitude. - -type: geo_point - -example: { "lon": -73.614830, "lat": 45.505918 } - --- - -*`server.geo.name`*:: -+ --- -User-defined description of a location, at the level of granularity they care about. -Could be the name of their data centers, the floor number, if this describes a local physical entity, city names. -Not typically used in automated geolocation. - -type: keyword - -example: boston-dc - --- - -*`server.geo.postal_code`*:: -+ --- -Postal code associated with the location. -Values appropriate for this field may also be known as a postcode or ZIP code and will vary widely from country to country. - -type: keyword - -example: 94040 - --- - -*`server.geo.region_iso_code`*:: -+ --- -Region ISO code. - -type: keyword - -example: CA-QC - --- - -*`server.geo.region_name`*:: -+ --- -Region name. - -type: keyword - -example: Quebec - --- - -*`server.geo.timezone`*:: -+ --- -The time zone of the location, such as IANA time zone name. - -type: keyword - -example: America/Argentina/Buenos_Aires - --- - -*`server.ip`*:: -+ --- -IP address of the server (IPv4 or IPv6). - -type: ip - --- - -*`server.mac`*:: -+ --- -MAC address of the server. -The notation format from RFC 7042 is suggested: Each octet (that is, 8-bit byte) is represented by two [uppercase] hexadecimal digits giving the value of the octet as an unsigned integer. Successive octets are separated by a hyphen. - -type: keyword - -example: 00-00-5E-00-53-23 - --- - -*`server.nat.ip`*:: -+ --- -Translated ip of destination based NAT sessions (e.g. internet to private DMZ) -Typically used with load balancers, firewalls, or routers. - -type: ip - --- - -*`server.nat.port`*:: -+ --- -Translated port of destination based NAT sessions (e.g. internet to private DMZ) -Typically used with load balancers, firewalls, or routers. - -type: long - -format: string - --- - -*`server.packets`*:: -+ --- -Packets sent from the server to the client. - -type: long - -example: 12 - --- - -*`server.port`*:: -+ --- -Port of the server. - -type: long - -format: string - --- - -*`server.registered_domain`*:: -+ --- -The highest registered server domain, stripped of the subdomain. -For example, the registered domain for "foo.example.com" is "example.com". -This value can be determined precisely with a list like the public suffix list (http://publicsuffix.org). Trying to approximate this by simply taking the last two labels will not work well for TLDs such as "co.uk". - -type: keyword - -example: example.com - --- - -*`server.subdomain`*:: -+ --- -The subdomain portion of a fully qualified domain name includes all of the names except the host name under the registered_domain. In a partially qualified domain, or if the the qualification level of the full name cannot be determined, subdomain contains all of the names below the registered domain. -For example the subdomain portion of "www.east.mydomain.co.uk" is "east". If the domain has multiple levels of subdomain, such as "sub2.sub1.example.com", the subdomain field should contain "sub2.sub1", with no trailing period. - -type: keyword - -example: east - --- - -*`server.top_level_domain`*:: -+ --- -The effective top level domain (eTLD), also known as the domain suffix, is the last part of the domain name. For example, the top level domain for example.com is "com". -This value can be determined precisely with a list like the public suffix list (http://publicsuffix.org). Trying to approximate this by simply taking the last label will not work well for effective TLDs such as "co.uk". - -type: keyword - -example: co.uk - --- - -*`server.user.domain`*:: -+ --- -Name of the directory the user is a member of. -For example, an LDAP or Active Directory domain name. - -type: keyword - --- - -*`server.user.email`*:: -+ --- -User email address. - -type: keyword - --- - -*`server.user.full_name`*:: -+ --- -User's full name, if available. - -type: keyword - -example: Albert Einstein - --- - -*`server.user.full_name.text`*:: -+ --- -type: match_only_text - --- - -*`server.user.group.domain`*:: -+ --- -Name of the directory the group is a member of. -For example, an LDAP or Active Directory domain name. - -type: keyword - --- - -*`server.user.group.id`*:: -+ --- -Unique identifier for the group on the system/platform. - -type: keyword - --- - -*`server.user.group.name`*:: -+ --- -Name of the group. - -type: keyword - --- - -*`server.user.hash`*:: -+ --- -Unique user hash to correlate information for a user in anonymized form. -Useful if `user.id` or `user.name` contain confidential information and cannot be used. - -type: keyword - --- - -*`server.user.id`*:: -+ --- -Unique identifier of the user. - -type: keyword - -example: S-1-5-21-202424912787-2692429404-2351956786-1000 - --- - -*`server.user.name`*:: -+ --- -Short name or login of the user. - -type: keyword - -example: a.einstein - --- - -*`server.user.name.text`*:: -+ --- -type: match_only_text - --- - -*`server.user.roles`*:: -+ --- -Array of user roles at the time of the event. - -type: keyword - -example: ["kibana_admin", "reporting_user"] - --- - -[float] -=== service - -The service fields describe the service for or from which the data was collected. -These fields help you find and correlate logs for a specific service and version. - - -*`service.address`*:: -+ --- -Address where data about this service was collected from. -This should be a URI, network address (ipv4:port or [ipv6]:port) or a resource path (sockets). - -type: keyword - -example: 172.26.0.2:5432 - --- - -*`service.environment`*:: -+ --- -Identifies the environment where the service is running. -If the same service runs in different environments (production, staging, QA, development, etc.), the environment can identify other instances of the same service. Can also group services and applications from the same environment. - -type: keyword - -example: production - --- - -*`service.ephemeral_id`*:: -+ --- -Ephemeral identifier of this service (if one exists). -This id normally changes across restarts, but `service.id` does not. - -type: keyword - -example: 8a4f500f - --- - -*`service.id`*:: -+ --- -Unique identifier of the running service. If the service is comprised of many nodes, the `service.id` should be the same for all nodes. -This id should uniquely identify the service. This makes it possible to correlate logs and metrics for one specific service, no matter which particular node emitted the event. -Note that if you need to see the events from one specific host of the service, you should filter on that `host.name` or `host.id` instead. - -type: keyword - -example: d37e5ebfe0ae6c4972dbe9f0174a1637bb8247f6 - --- - -*`service.name`*:: -+ --- -Name of the service data is collected from. -The name of the service is normally user given. This allows for distributed services that run on multiple hosts to correlate the related instances based on the name. -In the case of Elasticsearch the `service.name` could contain the cluster name. For Beats the `service.name` is by default a copy of the `service.type` field if no name is specified. - -type: keyword - -example: elasticsearch-metrics - --- - -*`service.node.name`*:: -+ --- -Name of a service node. -This allows for two nodes of the same service running on the same host to be differentiated. Therefore, `service.node.name` should typically be unique across nodes of a given service. -In the case of Elasticsearch, the `service.node.name` could contain the unique node name within the Elasticsearch cluster. In cases where the service doesn't have the concept of a node name, the host name or container name can be used to distinguish running instances that make up this service. If those do not provide uniqueness (e.g. multiple instances of the service running on the same host) - the node name can be manually set. - -type: keyword - -example: instance-0000000016 - --- - -*`service.origin.address`*:: -+ --- -Address where data about this service was collected from. -This should be a URI, network address (ipv4:port or [ipv6]:port) or a resource path (sockets). - -type: keyword - -example: 172.26.0.2:5432 - --- - -*`service.origin.environment`*:: -+ --- -Identifies the environment where the service is running. -If the same service runs in different environments (production, staging, QA, development, etc.), the environment can identify other instances of the same service. Can also group services and applications from the same environment. - -type: keyword - -example: production - --- - -*`service.origin.ephemeral_id`*:: -+ --- -Ephemeral identifier of this service (if one exists). -This id normally changes across restarts, but `service.id` does not. - -type: keyword - -example: 8a4f500f - --- - -*`service.origin.id`*:: -+ --- -Unique identifier of the running service. If the service is comprised of many nodes, the `service.id` should be the same for all nodes. -This id should uniquely identify the service. This makes it possible to correlate logs and metrics for one specific service, no matter which particular node emitted the event. -Note that if you need to see the events from one specific host of the service, you should filter on that `host.name` or `host.id` instead. - -type: keyword - -example: d37e5ebfe0ae6c4972dbe9f0174a1637bb8247f6 - --- - -*`service.origin.name`*:: -+ --- -Name of the service data is collected from. -The name of the service is normally user given. This allows for distributed services that run on multiple hosts to correlate the related instances based on the name. -In the case of Elasticsearch the `service.name` could contain the cluster name. For Beats the `service.name` is by default a copy of the `service.type` field if no name is specified. - -type: keyword - -example: elasticsearch-metrics - --- - -*`service.origin.node.name`*:: -+ --- -Name of a service node. -This allows for two nodes of the same service running on the same host to be differentiated. Therefore, `service.node.name` should typically be unique across nodes of a given service. -In the case of Elasticsearch, the `service.node.name` could contain the unique node name within the Elasticsearch cluster. In cases where the service doesn't have the concept of a node name, the host name or container name can be used to distinguish running instances that make up this service. If those do not provide uniqueness (e.g. multiple instances of the service running on the same host) - the node name can be manually set. - -type: keyword - -example: instance-0000000016 - --- - -*`service.origin.state`*:: -+ --- -Current state of the service. - -type: keyword - --- - -*`service.origin.type`*:: -+ --- -The type of the service data is collected from. -The type can be used to group and correlate logs and metrics from one service type. -Example: If logs or metrics are collected from Elasticsearch, `service.type` would be `elasticsearch`. - -type: keyword - -example: elasticsearch - --- - -*`service.origin.version`*:: -+ --- -Version of the service the data was collected from. -This allows to look at a data set only for a specific version of a service. - -type: keyword - -example: 3.2.4 - --- - -*`service.state`*:: -+ --- -Current state of the service. - -type: keyword - --- - -*`service.target.address`*:: -+ --- -Address where data about this service was collected from. -This should be a URI, network address (ipv4:port or [ipv6]:port) or a resource path (sockets). - -type: keyword - -example: 172.26.0.2:5432 - --- - -*`service.target.environment`*:: -+ --- -Identifies the environment where the service is running. -If the same service runs in different environments (production, staging, QA, development, etc.), the environment can identify other instances of the same service. Can also group services and applications from the same environment. - -type: keyword - -example: production - --- - -*`service.target.ephemeral_id`*:: -+ --- -Ephemeral identifier of this service (if one exists). -This id normally changes across restarts, but `service.id` does not. - -type: keyword - -example: 8a4f500f - --- - -*`service.target.id`*:: -+ --- -Unique identifier of the running service. If the service is comprised of many nodes, the `service.id` should be the same for all nodes. -This id should uniquely identify the service. This makes it possible to correlate logs and metrics for one specific service, no matter which particular node emitted the event. -Note that if you need to see the events from one specific host of the service, you should filter on that `host.name` or `host.id` instead. - -type: keyword - -example: d37e5ebfe0ae6c4972dbe9f0174a1637bb8247f6 - --- - -*`service.target.name`*:: -+ --- -Name of the service data is collected from. -The name of the service is normally user given. This allows for distributed services that run on multiple hosts to correlate the related instances based on the name. -In the case of Elasticsearch the `service.name` could contain the cluster name. For Beats the `service.name` is by default a copy of the `service.type` field if no name is specified. - -type: keyword - -example: elasticsearch-metrics - --- - -*`service.target.node.name`*:: -+ --- -Name of a service node. -This allows for two nodes of the same service running on the same host to be differentiated. Therefore, `service.node.name` should typically be unique across nodes of a given service. -In the case of Elasticsearch, the `service.node.name` could contain the unique node name within the Elasticsearch cluster. In cases where the service doesn't have the concept of a node name, the host name or container name can be used to distinguish running instances that make up this service. If those do not provide uniqueness (e.g. multiple instances of the service running on the same host) - the node name can be manually set. - -type: keyword - -example: instance-0000000016 - --- - -*`service.target.state`*:: -+ --- -Current state of the service. - -type: keyword - --- - -*`service.target.type`*:: -+ --- -The type of the service data is collected from. -The type can be used to group and correlate logs and metrics from one service type. -Example: If logs or metrics are collected from Elasticsearch, `service.type` would be `elasticsearch`. - -type: keyword - -example: elasticsearch - --- - -*`service.target.version`*:: -+ --- -Version of the service the data was collected from. -This allows to look at a data set only for a specific version of a service. - -type: keyword - -example: 3.2.4 - --- - -*`service.type`*:: -+ --- -The type of the service data is collected from. -The type can be used to group and correlate logs and metrics from one service type. -Example: If logs or metrics are collected from Elasticsearch, `service.type` would be `elasticsearch`. - -type: keyword - -example: elasticsearch - --- - -*`service.version`*:: -+ --- -Version of the service the data was collected from. -This allows to look at a data set only for a specific version of a service. - -type: keyword - -example: 3.2.4 - --- - -[float] -=== source - -Source fields capture details about the sender of a network exchange/packet. These fields are populated from a network event, packet, or other event containing details of a network transaction. -Source fields are usually populated in conjunction with destination fields. The source and destination fields are considered the baseline and should always be filled if an event contains source and destination details from a network transaction. If the event also contains identification of the client and server roles, then the client and server fields should also be populated. - - -*`source.address`*:: -+ --- -Some event source addresses are defined ambiguously. The event will sometimes list an IP, a domain or a unix socket. You should always store the raw address in the `.address` field. -Then it should be duplicated to `.ip` or `.domain`, depending on which one it is. - -type: keyword - --- - -*`source.as.number`*:: -+ --- -Unique number allocated to the autonomous system. The autonomous system number (ASN) uniquely identifies each network on the Internet. - -type: long - -example: 15169 - --- - -*`source.as.organization.name`*:: -+ --- -Organization name. - -type: keyword - -example: Google LLC - --- - -*`source.as.organization.name.text`*:: -+ --- -type: match_only_text - --- - -*`source.bytes`*:: -+ --- -Bytes sent from the source to the destination. - -type: long - -example: 184 - -format: bytes - --- - -*`source.domain`*:: -+ --- -The domain name of the source system. -This value may be a host name, a fully qualified domain name, or another host naming format. The value may derive from the original event or be added from enrichment. - -type: keyword - -example: foo.example.com - --- - -*`source.geo.city_name`*:: -+ --- -City name. - -type: keyword - -example: Montreal - --- - -*`source.geo.continent_code`*:: -+ --- -Two-letter code representing continent's name. - -type: keyword - -example: NA - --- - -*`source.geo.continent_name`*:: -+ --- -Name of the continent. - -type: keyword - -example: North America - --- - -*`source.geo.country_iso_code`*:: -+ --- -Country ISO code. - -type: keyword - -example: CA - --- - -*`source.geo.country_name`*:: -+ --- -Country name. - -type: keyword - -example: Canada - --- - -*`source.geo.location`*:: -+ --- -Longitude and latitude. - -type: geo_point - -example: { "lon": -73.614830, "lat": 45.505918 } - --- - -*`source.geo.name`*:: -+ --- -User-defined description of a location, at the level of granularity they care about. -Could be the name of their data centers, the floor number, if this describes a local physical entity, city names. -Not typically used in automated geolocation. - -type: keyword - -example: boston-dc - --- - -*`source.geo.postal_code`*:: -+ --- -Postal code associated with the location. -Values appropriate for this field may also be known as a postcode or ZIP code and will vary widely from country to country. - -type: keyword - -example: 94040 - --- - -*`source.geo.region_iso_code`*:: -+ --- -Region ISO code. - -type: keyword - -example: CA-QC - --- - -*`source.geo.region_name`*:: -+ --- -Region name. - -type: keyword - -example: Quebec - --- - -*`source.geo.timezone`*:: -+ --- -The time zone of the location, such as IANA time zone name. - -type: keyword - -example: America/Argentina/Buenos_Aires - --- - -*`source.ip`*:: -+ --- -IP address of the source (IPv4 or IPv6). - -type: ip - --- - -*`source.mac`*:: -+ --- -MAC address of the source. -The notation format from RFC 7042 is suggested: Each octet (that is, 8-bit byte) is represented by two [uppercase] hexadecimal digits giving the value of the octet as an unsigned integer. Successive octets are separated by a hyphen. - -type: keyword - -example: 00-00-5E-00-53-23 - --- - -*`source.nat.ip`*:: -+ --- -Translated ip of source based NAT sessions (e.g. internal client to internet) -Typically connections traversing load balancers, firewalls, or routers. - -type: ip - --- - -*`source.nat.port`*:: -+ --- -Translated port of source based NAT sessions. (e.g. internal client to internet) -Typically used with load balancers, firewalls, or routers. - -type: long - -format: string - --- - -*`source.packets`*:: -+ --- -Packets sent from the source to the destination. - -type: long - -example: 12 - --- - -*`source.port`*:: -+ --- -Port of the source. - -type: long - -format: string - --- - -*`source.registered_domain`*:: -+ --- -The highest registered source domain, stripped of the subdomain. -For example, the registered domain for "foo.example.com" is "example.com". -This value can be determined precisely with a list like the public suffix list (http://publicsuffix.org). Trying to approximate this by simply taking the last two labels will not work well for TLDs such as "co.uk". - -type: keyword - -example: example.com - --- - -*`source.subdomain`*:: -+ --- -The subdomain portion of a fully qualified domain name includes all of the names except the host name under the registered_domain. In a partially qualified domain, or if the the qualification level of the full name cannot be determined, subdomain contains all of the names below the registered domain. -For example the subdomain portion of "www.east.mydomain.co.uk" is "east". If the domain has multiple levels of subdomain, such as "sub2.sub1.example.com", the subdomain field should contain "sub2.sub1", with no trailing period. - -type: keyword - -example: east - --- - -*`source.top_level_domain`*:: -+ --- -The effective top level domain (eTLD), also known as the domain suffix, is the last part of the domain name. For example, the top level domain for example.com is "com". -This value can be determined precisely with a list like the public suffix list (http://publicsuffix.org). Trying to approximate this by simply taking the last label will not work well for effective TLDs such as "co.uk". - -type: keyword - -example: co.uk - --- - -*`source.user.domain`*:: -+ --- -Name of the directory the user is a member of. -For example, an LDAP or Active Directory domain name. - -type: keyword - --- - -*`source.user.email`*:: -+ --- -User email address. - -type: keyword - --- - -*`source.user.full_name`*:: -+ --- -User's full name, if available. - -type: keyword - -example: Albert Einstein - --- - -*`source.user.full_name.text`*:: -+ --- -type: match_only_text - --- - -*`source.user.group.domain`*:: -+ --- -Name of the directory the group is a member of. -For example, an LDAP or Active Directory domain name. - -type: keyword - --- - -*`source.user.group.id`*:: -+ --- -Unique identifier for the group on the system/platform. - -type: keyword - --- - -*`source.user.group.name`*:: -+ --- -Name of the group. - -type: keyword - --- - -*`source.user.hash`*:: -+ --- -Unique user hash to correlate information for a user in anonymized form. -Useful if `user.id` or `user.name` contain confidential information and cannot be used. - -type: keyword - --- - -*`source.user.id`*:: -+ --- -Unique identifier of the user. - -type: keyword - -example: S-1-5-21-202424912787-2692429404-2351956786-1000 - --- - -*`source.user.name`*:: -+ --- -Short name or login of the user. - -type: keyword - -example: a.einstein - --- - -*`source.user.name.text`*:: -+ --- -type: match_only_text - --- - -*`source.user.roles`*:: -+ --- -Array of user roles at the time of the event. - -type: keyword - -example: ["kibana_admin", "reporting_user"] - --- - -[float] -=== threat - -Fields to classify events and alerts according to a threat taxonomy such as the MITRE ATT&CK® framework. -These fields are for users to classify alerts from all of their sources (e.g. IDS, NGFW, etc.) within a common taxonomy. The threat.tactic.* fields are meant to capture the high level category of the threat (e.g. "impact"). The threat.technique.* fields are meant to capture which kind of approach is used by this detected threat, to accomplish the goal (e.g. "endpoint denial of service"). - - -*`threat.enrichments`*:: -+ --- -A list of associated indicators objects enriching the event, and the context of that association/enrichment. - -type: nested - --- - -*`threat.enrichments.indicator`*:: -+ --- -Object containing associated indicators enriching the event. - -type: object - --- - -*`threat.enrichments.indicator.as.number`*:: -+ --- -Unique number allocated to the autonomous system. The autonomous system number (ASN) uniquely identifies each network on the Internet. - -type: long - -example: 15169 - --- - -*`threat.enrichments.indicator.as.organization.name`*:: -+ --- -Organization name. - -type: keyword - -example: Google LLC - --- - -*`threat.enrichments.indicator.as.organization.name.text`*:: -+ --- -type: match_only_text - --- - -*`threat.enrichments.indicator.confidence`*:: -+ --- -Identifies the vendor-neutral confidence rating using the None/Low/Medium/High scale defined in Appendix A of the STIX 2.1 framework. Vendor-specific confidence scales may be added as custom fields. -Expected values are: - * Not Specified - * None - * Low - * Medium - * High - -type: keyword - -example: Medium - --- - -*`threat.enrichments.indicator.description`*:: -+ --- -Describes the type of action conducted by the threat. - -type: keyword - -example: IP x.x.x.x was observed delivering the Angler EK. - --- - -*`threat.enrichments.indicator.email.address`*:: -+ --- -Identifies a threat indicator as an email address (irrespective of direction). - -type: keyword - -example: phish@example.com - --- - -*`threat.enrichments.indicator.file.accessed`*:: -+ --- -Last time the file was accessed. -Note that not all filesystems keep track of access time. - -type: date - --- - -*`threat.enrichments.indicator.file.attributes`*:: -+ --- -Array of file attributes. -Attributes names will vary by platform. Here's a non-exhaustive list of values that are expected in this field: archive, compressed, directory, encrypted, execute, hidden, read, readonly, system, write. - -type: keyword - -example: ["readonly", "system"] - --- - -*`threat.enrichments.indicator.file.code_signature.digest_algorithm`*:: -+ --- -The hashing algorithm used to sign the process. -This value can distinguish signatures when a file is signed multiple times by the same signer but with a different digest algorithm. - -type: keyword - -example: sha256 - --- - -*`threat.enrichments.indicator.file.code_signature.exists`*:: -+ --- -Boolean to capture if a signature is present. - -type: boolean - -example: true - --- - -*`threat.enrichments.indicator.file.code_signature.signing_id`*:: -+ --- -The identifier used to sign the process. -This is used to identify the application manufactured by a software vendor. The field is relevant to Apple *OS only. - -type: keyword - -example: com.apple.xpc.proxy - --- - -*`threat.enrichments.indicator.file.code_signature.status`*:: -+ --- -Additional information about the certificate status. -This is useful for logging cryptographic errors with the certificate validity or trust status. Leave unpopulated if the validity or trust of the certificate was unchecked. - -type: keyword - -example: ERROR_UNTRUSTED_ROOT - --- - -*`threat.enrichments.indicator.file.code_signature.subject_name`*:: -+ --- -Subject name of the code signer - -type: keyword - -example: Microsoft Corporation - --- - -*`threat.enrichments.indicator.file.code_signature.team_id`*:: -+ --- -The team identifier used to sign the process. -This is used to identify the team or vendor of a software product. The field is relevant to Apple *OS only. - -type: keyword - -example: EQHXZ8M8AV - --- - -*`threat.enrichments.indicator.file.code_signature.timestamp`*:: -+ --- -Date and time when the code signature was generated and signed. - -type: date - -example: 2021-01-01T12:10:30Z - --- - -*`threat.enrichments.indicator.file.code_signature.trusted`*:: -+ --- -Stores the trust status of the certificate chain. -Validating the trust of the certificate chain may be complicated, and this field should only be populated by tools that actively check the status. - -type: boolean - -example: true - --- - -*`threat.enrichments.indicator.file.code_signature.valid`*:: -+ --- -Boolean to capture if the digital signature is verified against the binary content. -Leave unpopulated if a certificate was unchecked. - -type: boolean - -example: true - --- - -*`threat.enrichments.indicator.file.created`*:: -+ --- -File creation time. -Note that not all filesystems store the creation time. - -type: date - --- - -*`threat.enrichments.indicator.file.ctime`*:: -+ --- -Last time the file attributes or metadata changed. -Note that changes to the file content will update `mtime`. This implies `ctime` will be adjusted at the same time, since `mtime` is an attribute of the file. - -type: date - --- - -*`threat.enrichments.indicator.file.device`*:: -+ --- -Device that is the source of the file. - -type: keyword - -example: sda - --- - -*`threat.enrichments.indicator.file.directory`*:: -+ --- -Directory where the file is located. It should include the drive letter, when appropriate. - -type: keyword - -example: /home/alice - --- - -*`threat.enrichments.indicator.file.drive_letter`*:: -+ --- -Drive letter where the file is located. This field is only relevant on Windows. -The value should be uppercase, and not include the colon. - -type: keyword - -example: C - --- - -*`threat.enrichments.indicator.file.elf.architecture`*:: -+ --- -Machine architecture of the ELF file. - -type: keyword - -example: x86-64 - --- - -*`threat.enrichments.indicator.file.elf.byte_order`*:: -+ --- -Byte sequence of ELF file. - -type: keyword - -example: Little Endian - --- - -*`threat.enrichments.indicator.file.elf.cpu_type`*:: -+ --- -CPU type of the ELF file. - -type: keyword - -example: Intel - --- - -*`threat.enrichments.indicator.file.elf.creation_date`*:: -+ --- -Extracted when possible from the file's metadata. Indicates when it was built or compiled. It can also be faked by malware creators. - -type: date - --- - -*`threat.enrichments.indicator.file.elf.exports`*:: -+ --- -List of exported element names and types. - -type: flattened - --- - -*`threat.enrichments.indicator.file.elf.header.abi_version`*:: -+ --- -Version of the ELF Application Binary Interface (ABI). - -type: keyword - --- - -*`threat.enrichments.indicator.file.elf.header.class`*:: -+ --- -Header class of the ELF file. - -type: keyword - --- - -*`threat.enrichments.indicator.file.elf.header.data`*:: -+ --- -Data table of the ELF header. - -type: keyword - --- - -*`threat.enrichments.indicator.file.elf.header.entrypoint`*:: -+ --- -Header entrypoint of the ELF file. - -type: long - -format: string - --- - -*`threat.enrichments.indicator.file.elf.header.object_version`*:: -+ --- -"0x1" for original ELF files. - -type: keyword - --- - -*`threat.enrichments.indicator.file.elf.header.os_abi`*:: -+ --- -Application Binary Interface (ABI) of the Linux OS. - -type: keyword - --- - -*`threat.enrichments.indicator.file.elf.header.type`*:: -+ --- -Header type of the ELF file. - -type: keyword - --- - -*`threat.enrichments.indicator.file.elf.header.version`*:: -+ --- -Version of the ELF header. - -type: keyword - --- - -*`threat.enrichments.indicator.file.elf.imports`*:: -+ --- -List of imported element names and types. - -type: flattened - --- - -*`threat.enrichments.indicator.file.elf.sections`*:: -+ --- -An array containing an object for each section of the ELF file. -The keys that should be present in these objects are defined by sub-fields underneath `elf.sections.*`. - -type: nested - --- - -*`threat.enrichments.indicator.file.elf.sections.chi2`*:: -+ --- -Chi-square probability distribution of the section. - -type: long - -format: number - --- - -*`threat.enrichments.indicator.file.elf.sections.entropy`*:: -+ --- -Shannon entropy calculation from the section. - -type: long - -format: number - --- - -*`threat.enrichments.indicator.file.elf.sections.flags`*:: -+ --- -ELF Section List flags. - -type: keyword - --- - -*`threat.enrichments.indicator.file.elf.sections.name`*:: -+ --- -ELF Section List name. - -type: keyword - --- - -*`threat.enrichments.indicator.file.elf.sections.physical_offset`*:: -+ --- -ELF Section List offset. - -type: keyword - --- - -*`threat.enrichments.indicator.file.elf.sections.physical_size`*:: -+ --- -ELF Section List physical size. - -type: long - -format: bytes - --- - -*`threat.enrichments.indicator.file.elf.sections.type`*:: -+ --- -ELF Section List type. - -type: keyword - --- - -*`threat.enrichments.indicator.file.elf.sections.virtual_address`*:: -+ --- -ELF Section List virtual address. - -type: long - -format: string - --- - -*`threat.enrichments.indicator.file.elf.sections.virtual_size`*:: -+ --- -ELF Section List virtual size. - -type: long - -format: string - --- - -*`threat.enrichments.indicator.file.elf.segments`*:: -+ --- -An array containing an object for each segment of the ELF file. -The keys that should be present in these objects are defined by sub-fields underneath `elf.segments.*`. - -type: nested - --- - -*`threat.enrichments.indicator.file.elf.segments.sections`*:: -+ --- -ELF object segment sections. - -type: keyword - --- - -*`threat.enrichments.indicator.file.elf.segments.type`*:: -+ --- -ELF object segment type. - -type: keyword - --- - -*`threat.enrichments.indicator.file.elf.shared_libraries`*:: -+ --- -List of shared libraries used by this ELF object. - -type: keyword - --- - -*`threat.enrichments.indicator.file.elf.telfhash`*:: -+ --- -telfhash symbol hash for ELF file. - -type: keyword - --- - -*`threat.enrichments.indicator.file.extension`*:: -+ --- -File extension, excluding the leading dot. -Note that when the file name has multiple extensions (example.tar.gz), only the last one should be captured ("gz", not "tar.gz"). - -type: keyword - -example: png - --- - -*`threat.enrichments.indicator.file.fork_name`*:: -+ --- -A fork is additional data associated with a filesystem object. -On Linux, a resource fork is used to store additional data with a filesystem object. A file always has at least one fork for the data portion, and additional forks may exist. -On NTFS, this is analogous to an Alternate Data Stream (ADS), and the default data stream for a file is just called $DATA. Zone.Identifier is commonly used by Windows to track contents downloaded from the Internet. An ADS is typically of the form: `C:\path\to\filename.extension:some_fork_name`, and `some_fork_name` is the value that should populate `fork_name`. `filename.extension` should populate `file.name`, and `extension` should populate `file.extension`. The full path, `file.path`, will include the fork name. - -type: keyword - -example: Zone.Identifer - --- - -*`threat.enrichments.indicator.file.gid`*:: -+ --- -Primary group ID (GID) of the file. - -type: keyword - -example: 1001 - --- - -*`threat.enrichments.indicator.file.group`*:: -+ --- -Primary group name of the file. - -type: keyword - -example: alice - --- - -*`threat.enrichments.indicator.file.hash.md5`*:: -+ --- -MD5 hash. - -type: keyword - --- - -*`threat.enrichments.indicator.file.hash.sha1`*:: -+ --- -SHA1 hash. - -type: keyword - --- - -*`threat.enrichments.indicator.file.hash.sha256`*:: -+ --- -SHA256 hash. - -type: keyword - --- - -*`threat.enrichments.indicator.file.hash.sha512`*:: -+ --- -SHA512 hash. - -type: keyword - --- - -*`threat.enrichments.indicator.file.hash.ssdeep`*:: -+ --- -SSDEEP hash. - -type: keyword - --- - -*`threat.enrichments.indicator.file.inode`*:: -+ --- -Inode representing the file in the filesystem. - -type: keyword - -example: 256383 - --- - -*`threat.enrichments.indicator.file.mime_type`*:: -+ --- -MIME type should identify the format of the file or stream of bytes using https://www.iana.org/assignments/media-types/media-types.xhtml[IANA official types], where possible. When more than one type is applicable, the most specific type should be used. - -type: keyword - --- - -*`threat.enrichments.indicator.file.mode`*:: -+ --- -Mode of the file in octal representation. - -type: keyword - -example: 0640 - --- - -*`threat.enrichments.indicator.file.mtime`*:: -+ --- -Last time the file content was modified. - -type: date - --- - -*`threat.enrichments.indicator.file.name`*:: -+ --- -Name of the file including the extension, without the directory. - -type: keyword - -example: example.png - --- - -*`threat.enrichments.indicator.file.owner`*:: -+ --- -File owner's username. - -type: keyword - -example: alice - --- - -*`threat.enrichments.indicator.file.path`*:: -+ --- -Full path to the file, including the file name. It should include the drive letter, when appropriate. - -type: keyword - -example: /home/alice/example.png - --- - -*`threat.enrichments.indicator.file.path.text`*:: -+ --- -type: match_only_text - --- - -*`threat.enrichments.indicator.file.pe.architecture`*:: -+ --- -CPU architecture target for the file. - -type: keyword - -example: x64 - --- - -*`threat.enrichments.indicator.file.pe.company`*:: -+ --- -Internal company name of the file, provided at compile-time. - -type: keyword - -example: Microsoft Corporation - --- - -*`threat.enrichments.indicator.file.pe.description`*:: -+ --- -Internal description of the file, provided at compile-time. - -type: keyword - -example: Paint - --- - -*`threat.enrichments.indicator.file.pe.file_version`*:: -+ --- -Internal version of the file, provided at compile-time. - -type: keyword - -example: 6.3.9600.17415 - --- - -*`threat.enrichments.indicator.file.pe.imphash`*:: -+ --- -A hash of the imports in a PE file. An imphash -- or import hash -- can be used to fingerprint binaries even after recompilation or other code-level transformations have occurred, which would change more traditional hash values. -Learn more at https://www.fireeye.com/blog/threat-research/2014/01/tracking-malware-import-hashing.html. - -type: keyword - -example: 0c6803c4e922103c4dca5963aad36ddf - --- - -*`threat.enrichments.indicator.file.pe.original_file_name`*:: -+ --- -Internal name of the file, provided at compile-time. - -type: keyword - -example: MSPAINT.EXE - --- - -*`threat.enrichments.indicator.file.pe.product`*:: -+ --- -Internal product name of the file, provided at compile-time. - -type: keyword - -example: Microsoft® Windows® Operating System - --- - -*`threat.enrichments.indicator.file.size`*:: -+ --- -File size in bytes. -Only relevant when `file.type` is "file". - -type: long - -example: 16384 - --- - -*`threat.enrichments.indicator.file.target_path`*:: -+ --- -Target path for symlinks. - -type: keyword - --- - -*`threat.enrichments.indicator.file.target_path.text`*:: -+ --- -type: match_only_text - --- - -*`threat.enrichments.indicator.file.type`*:: -+ --- -File type (file, dir, or symlink). - -type: keyword - -example: file - --- - -*`threat.enrichments.indicator.file.uid`*:: -+ --- -The user ID (UID) or security identifier (SID) of the file owner. - -type: keyword - -example: 1001 - --- - -*`threat.enrichments.indicator.file.x509.alternative_names`*:: -+ --- -List of subject alternative names (SAN). Name types vary by certificate authority and certificate type but commonly contain IP addresses, DNS names (and wildcards), and email addresses. - -type: keyword - -example: *.elastic.co - --- - -*`threat.enrichments.indicator.file.x509.issuer.common_name`*:: -+ --- -List of common name (CN) of issuing certificate authority. - -type: keyword - -example: Example SHA2 High Assurance Server CA - --- - -*`threat.enrichments.indicator.file.x509.issuer.country`*:: -+ --- -List of country (C) codes - -type: keyword - -example: US - --- - -*`threat.enrichments.indicator.file.x509.issuer.distinguished_name`*:: -+ --- -Distinguished name (DN) of issuing certificate authority. - -type: keyword - -example: C=US, O=Example Inc, OU=www.example.com, CN=Example SHA2 High Assurance Server CA - --- - -*`threat.enrichments.indicator.file.x509.issuer.locality`*:: -+ --- -List of locality names (L) - -type: keyword - -example: Mountain View - --- - -*`threat.enrichments.indicator.file.x509.issuer.organization`*:: -+ --- -List of organizations (O) of issuing certificate authority. - -type: keyword - -example: Example Inc - --- - -*`threat.enrichments.indicator.file.x509.issuer.organizational_unit`*:: -+ --- -List of organizational units (OU) of issuing certificate authority. - -type: keyword - -example: www.example.com - --- - -*`threat.enrichments.indicator.file.x509.issuer.state_or_province`*:: -+ --- -List of state or province names (ST, S, or P) - -type: keyword - -example: California - --- - -*`threat.enrichments.indicator.file.x509.not_after`*:: -+ --- -Time at which the certificate is no longer considered valid. - -type: date - -example: 2020-07-16 03:15:39+00:00 - --- - -*`threat.enrichments.indicator.file.x509.not_before`*:: -+ --- -Time at which the certificate is first considered valid. - -type: date - -example: 2019-08-16 01:40:25+00:00 - --- - -*`threat.enrichments.indicator.file.x509.public_key_algorithm`*:: -+ --- -Algorithm used to generate the public key. - -type: keyword - -example: RSA - --- - -*`threat.enrichments.indicator.file.x509.public_key_curve`*:: -+ --- -The curve used by the elliptic curve public key algorithm. This is algorithm specific. - -type: keyword - -example: nistp521 - --- - -*`threat.enrichments.indicator.file.x509.public_key_exponent`*:: -+ --- -Exponent used to derive the public key. This is algorithm specific. - -type: long - -example: 65537 - -Field is not indexed. - --- - -*`threat.enrichments.indicator.file.x509.public_key_size`*:: -+ --- -The size of the public key space in bits. - -type: long - -example: 2048 - --- - -*`threat.enrichments.indicator.file.x509.serial_number`*:: -+ --- -Unique serial number issued by the certificate authority. For consistency, if this value is alphanumeric, it should be formatted without colons and uppercase characters. - -type: keyword - -example: 55FBB9C7DEBF09809D12CCAA - --- - -*`threat.enrichments.indicator.file.x509.signature_algorithm`*:: -+ --- -Identifier for certificate signature algorithm. We recommend using names found in Go Lang Crypto library. See https://github.com/golang/go/blob/go1.14/src/crypto/x509/x509.go#L337-L353. - -type: keyword - -example: SHA256-RSA - --- - -*`threat.enrichments.indicator.file.x509.subject.common_name`*:: -+ --- -List of common names (CN) of subject. - -type: keyword - -example: shared.global.example.net - --- - -*`threat.enrichments.indicator.file.x509.subject.country`*:: -+ --- -List of country (C) code - -type: keyword - -example: US - --- - -*`threat.enrichments.indicator.file.x509.subject.distinguished_name`*:: -+ --- -Distinguished name (DN) of the certificate subject entity. - -type: keyword - -example: C=US, ST=California, L=San Francisco, O=Example, Inc., CN=shared.global.example.net - --- - -*`threat.enrichments.indicator.file.x509.subject.locality`*:: -+ --- -List of locality names (L) - -type: keyword - -example: San Francisco - --- - -*`threat.enrichments.indicator.file.x509.subject.organization`*:: -+ --- -List of organizations (O) of subject. - -type: keyword - -example: Example, Inc. - --- - -*`threat.enrichments.indicator.file.x509.subject.organizational_unit`*:: -+ --- -List of organizational units (OU) of subject. - -type: keyword - --- - -*`threat.enrichments.indicator.file.x509.subject.state_or_province`*:: -+ --- -List of state or province names (ST, S, or P) - -type: keyword - -example: California - --- - -*`threat.enrichments.indicator.file.x509.version_number`*:: -+ --- -Version of x509 format. - -type: keyword - -example: 3 - --- - -*`threat.enrichments.indicator.first_seen`*:: -+ --- -The date and time when intelligence source first reported sighting this indicator. - -type: date - -example: 2020-11-05T17:25:47.000Z - --- - -*`threat.enrichments.indicator.geo.city_name`*:: -+ --- -City name. - -type: keyword - -example: Montreal - --- - -*`threat.enrichments.indicator.geo.continent_code`*:: -+ --- -Two-letter code representing continent's name. - -type: keyword - -example: NA - --- - -*`threat.enrichments.indicator.geo.continent_name`*:: -+ --- -Name of the continent. - -type: keyword - -example: North America - --- - -*`threat.enrichments.indicator.geo.country_iso_code`*:: -+ --- -Country ISO code. - -type: keyword - -example: CA - --- - -*`threat.enrichments.indicator.geo.country_name`*:: -+ --- -Country name. - -type: keyword - -example: Canada - --- - -*`threat.enrichments.indicator.geo.location`*:: -+ --- -Longitude and latitude. - -type: geo_point - -example: { "lon": -73.614830, "lat": 45.505918 } - --- - -*`threat.enrichments.indicator.geo.name`*:: -+ --- -User-defined description of a location, at the level of granularity they care about. -Could be the name of their data centers, the floor number, if this describes a local physical entity, city names. -Not typically used in automated geolocation. - -type: keyword - -example: boston-dc - --- - -*`threat.enrichments.indicator.geo.postal_code`*:: -+ --- -Postal code associated with the location. -Values appropriate for this field may also be known as a postcode or ZIP code and will vary widely from country to country. - -type: keyword - -example: 94040 - --- - -*`threat.enrichments.indicator.geo.region_iso_code`*:: -+ --- -Region ISO code. - -type: keyword - -example: CA-QC - --- - -*`threat.enrichments.indicator.geo.region_name`*:: -+ --- -Region name. - -type: keyword - -example: Quebec - --- - -*`threat.enrichments.indicator.geo.timezone`*:: -+ --- -The time zone of the location, such as IANA time zone name. - -type: keyword - -example: America/Argentina/Buenos_Aires - --- - -*`threat.enrichments.indicator.ip`*:: -+ --- -Identifies a threat indicator as an IP address (irrespective of direction). - -type: ip - -example: 1.2.3.4 - --- - -*`threat.enrichments.indicator.last_seen`*:: -+ --- -The date and time when intelligence source last reported sighting this indicator. - -type: date - -example: 2020-11-05T17:25:47.000Z - --- - -*`threat.enrichments.indicator.marking.tlp`*:: -+ --- -Traffic Light Protocol sharing markings. Recommended values are: - * WHITE - * GREEN - * AMBER - * RED - -type: keyword - -example: White - --- - -*`threat.enrichments.indicator.modified_at`*:: -+ --- -The date and time when intelligence source last modified information for this indicator. - -type: date - -example: 2020-11-05T17:25:47.000Z - --- - -*`threat.enrichments.indicator.port`*:: -+ --- -Identifies a threat indicator as a port number (irrespective of direction). - -type: long - -example: 443 - --- - -*`threat.enrichments.indicator.provider`*:: -+ --- -The name of the indicator's provider. - -type: keyword - -example: lrz_urlhaus - --- - -*`threat.enrichments.indicator.reference`*:: -+ --- -Reference URL linking to additional information about this indicator. - -type: keyword - -example: https://system.example.com/indicator/0001234 - --- - -*`threat.enrichments.indicator.registry.data.bytes`*:: -+ --- -Original bytes written with base64 encoding. -For Windows registry operations, such as SetValueEx and RegQueryValueEx, this corresponds to the data pointed by `lp_data`. This is optional but provides better recoverability and should be populated for REG_BINARY encoded values. - -type: keyword - -example: ZQBuAC0AVQBTAAAAZQBuAAAAAAA= - --- - -*`threat.enrichments.indicator.registry.data.strings`*:: -+ --- -Content when writing string types. -Populated as an array when writing string data to the registry. For single string registry types (REG_SZ, REG_EXPAND_SZ), this should be an array with one string. For sequences of string with REG_MULTI_SZ, this array will be variable length. For numeric data, such as REG_DWORD and REG_QWORD, this should be populated with the decimal representation (e.g `"1"`). - -type: wildcard - -example: ["C:\rta\red_ttp\bin\myapp.exe"] - --- - -*`threat.enrichments.indicator.registry.data.type`*:: -+ --- -Standard registry type for encoding contents - -type: keyword - -example: REG_SZ - --- - -*`threat.enrichments.indicator.registry.hive`*:: -+ --- -Abbreviated name for the hive. - -type: keyword - -example: HKLM - --- - -*`threat.enrichments.indicator.registry.key`*:: -+ --- -Hive-relative path of keys. - -type: keyword - -example: SOFTWARE\Microsoft\Windows NT\CurrentVersion\Image File Execution Options\winword.exe - --- - -*`threat.enrichments.indicator.registry.path`*:: -+ --- -Full path, including hive, key and value - -type: keyword - -example: HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Image File Execution Options\winword.exe\Debugger - --- - -*`threat.enrichments.indicator.registry.value`*:: -+ --- -Name of the value written. - -type: keyword - -example: Debugger - --- - -*`threat.enrichments.indicator.scanner_stats`*:: -+ --- -Count of AV/EDR vendors that successfully detected malicious file or URL. - -type: long - -example: 4 - --- - -*`threat.enrichments.indicator.sightings`*:: -+ --- -Number of times this indicator was observed conducting threat activity. - -type: long - -example: 20 - --- - -*`threat.enrichments.indicator.type`*:: -+ --- -Type of indicator as represented by Cyber Observable in STIX 2.0. Recommended values: - * autonomous-system - * artifact - * directory - * domain-name - * email-addr - * file - * ipv4-addr - * ipv6-addr - * mac-addr - * mutex - * port - * process - * software - * url - * user-account - * windows-registry-key - * x509-certificate - -type: keyword - -example: ipv4-addr - --- - -*`threat.enrichments.indicator.url.domain`*:: -+ --- -Domain of the url, such as "www.elastic.co". -In some cases a URL may refer to an IP and/or port directly, without a domain name. In this case, the IP address would go to the `domain` field. -If the URL contains a literal IPv6 address enclosed by `[` and `]` (IETF RFC 2732), the `[` and `]` characters should also be captured in the `domain` field. - -type: keyword - -example: www.elastic.co - --- - -*`threat.enrichments.indicator.url.extension`*:: -+ --- -The field contains the file extension from the original request url, excluding the leading dot. -The file extension is only set if it exists, as not every url has a file extension. -The leading period must not be included. For example, the value must be "png", not ".png". -Note that when the file name has multiple extensions (example.tar.gz), only the last one should be captured ("gz", not "tar.gz"). - -type: keyword - -example: png - --- - -*`threat.enrichments.indicator.url.fragment`*:: -+ --- -Portion of the url after the `#`, such as "top". -The `#` is not part of the fragment. - -type: keyword - --- - -*`threat.enrichments.indicator.url.full`*:: -+ --- -If full URLs are important to your use case, they should be stored in `url.full`, whether this field is reconstructed or present in the event source. - -type: wildcard - -example: https://www.elastic.co:443/search?q=elasticsearch#top - --- - -*`threat.enrichments.indicator.url.full.text`*:: -+ --- -type: match_only_text - --- - -*`threat.enrichments.indicator.url.original`*:: -+ --- -Unmodified original url as seen in the event source. -Note that in network monitoring, the observed URL may be a full URL, whereas in access logs, the URL is often just represented as a path. -This field is meant to represent the URL as it was observed, complete or not. - -type: wildcard - -example: https://www.elastic.co:443/search?q=elasticsearch#top or /search?q=elasticsearch - --- - -*`threat.enrichments.indicator.url.original.text`*:: -+ --- -type: match_only_text - --- - -*`threat.enrichments.indicator.url.password`*:: -+ --- -Password of the request. - -type: keyword - --- - -*`threat.enrichments.indicator.url.path`*:: -+ --- -Path of the request, such as "/search". - -type: wildcard - --- - -*`threat.enrichments.indicator.url.port`*:: -+ --- -Port of the request, such as 443. - -type: long - -example: 443 - -format: string - --- - -*`threat.enrichments.indicator.url.query`*:: -+ --- -The query field describes the query string of the request, such as "q=elasticsearch". -The `?` is excluded from the query string. If a URL contains no `?`, there is no query field. If there is a `?` but no query, the query field exists with an empty string. The `exists` query can be used to differentiate between the two cases. - -type: keyword - --- - -*`threat.enrichments.indicator.url.registered_domain`*:: -+ --- -The highest registered url domain, stripped of the subdomain. -For example, the registered domain for "foo.example.com" is "example.com". -This value can be determined precisely with a list like the public suffix list (http://publicsuffix.org). Trying to approximate this by simply taking the last two labels will not work well for TLDs such as "co.uk". - -type: keyword - -example: example.com - --- - -*`threat.enrichments.indicator.url.scheme`*:: -+ --- -Scheme of the request, such as "https". -Note: The `:` is not part of the scheme. - -type: keyword - -example: https - --- - -*`threat.enrichments.indicator.url.subdomain`*:: -+ --- -The subdomain portion of a fully qualified domain name includes all of the names except the host name under the registered_domain. In a partially qualified domain, or if the the qualification level of the full name cannot be determined, subdomain contains all of the names below the registered domain. -For example the subdomain portion of "www.east.mydomain.co.uk" is "east". If the domain has multiple levels of subdomain, such as "sub2.sub1.example.com", the subdomain field should contain "sub2.sub1", with no trailing period. - -type: keyword - -example: east - --- - -*`threat.enrichments.indicator.url.top_level_domain`*:: -+ --- -The effective top level domain (eTLD), also known as the domain suffix, is the last part of the domain name. For example, the top level domain for example.com is "com". -This value can be determined precisely with a list like the public suffix list (http://publicsuffix.org). Trying to approximate this by simply taking the last label will not work well for effective TLDs such as "co.uk". - -type: keyword - -example: co.uk - --- - -*`threat.enrichments.indicator.url.username`*:: -+ --- -Username of the request. - -type: keyword - --- - -*`threat.enrichments.indicator.x509.alternative_names`*:: -+ --- -List of subject alternative names (SAN). Name types vary by certificate authority and certificate type but commonly contain IP addresses, DNS names (and wildcards), and email addresses. - -type: keyword - -example: *.elastic.co - --- - -*`threat.enrichments.indicator.x509.issuer.common_name`*:: -+ --- -List of common name (CN) of issuing certificate authority. - -type: keyword - -example: Example SHA2 High Assurance Server CA - --- - -*`threat.enrichments.indicator.x509.issuer.country`*:: -+ --- -List of country (C) codes - -type: keyword - -example: US - --- - -*`threat.enrichments.indicator.x509.issuer.distinguished_name`*:: -+ --- -Distinguished name (DN) of issuing certificate authority. - -type: keyword - -example: C=US, O=Example Inc, OU=www.example.com, CN=Example SHA2 High Assurance Server CA - --- - -*`threat.enrichments.indicator.x509.issuer.locality`*:: -+ --- -List of locality names (L) - -type: keyword - -example: Mountain View - --- - -*`threat.enrichments.indicator.x509.issuer.organization`*:: -+ --- -List of organizations (O) of issuing certificate authority. - -type: keyword - -example: Example Inc - --- - -*`threat.enrichments.indicator.x509.issuer.organizational_unit`*:: -+ --- -List of organizational units (OU) of issuing certificate authority. - -type: keyword - -example: www.example.com - --- - -*`threat.enrichments.indicator.x509.issuer.state_or_province`*:: -+ --- -List of state or province names (ST, S, or P) - -type: keyword - -example: California - --- - -*`threat.enrichments.indicator.x509.not_after`*:: -+ --- -Time at which the certificate is no longer considered valid. - -type: date - -example: 2020-07-16 03:15:39+00:00 - --- - -*`threat.enrichments.indicator.x509.not_before`*:: -+ --- -Time at which the certificate is first considered valid. - -type: date - -example: 2019-08-16 01:40:25+00:00 - --- - -*`threat.enrichments.indicator.x509.public_key_algorithm`*:: -+ --- -Algorithm used to generate the public key. - -type: keyword - -example: RSA - --- - -*`threat.enrichments.indicator.x509.public_key_curve`*:: -+ --- -The curve used by the elliptic curve public key algorithm. This is algorithm specific. - -type: keyword - -example: nistp521 - --- - -*`threat.enrichments.indicator.x509.public_key_exponent`*:: -+ --- -Exponent used to derive the public key. This is algorithm specific. - -type: long - -example: 65537 - -Field is not indexed. - --- - -*`threat.enrichments.indicator.x509.public_key_size`*:: -+ --- -The size of the public key space in bits. - -type: long - -example: 2048 - --- - -*`threat.enrichments.indicator.x509.serial_number`*:: -+ --- -Unique serial number issued by the certificate authority. For consistency, if this value is alphanumeric, it should be formatted without colons and uppercase characters. - -type: keyword - -example: 55FBB9C7DEBF09809D12CCAA - --- - -*`threat.enrichments.indicator.x509.signature_algorithm`*:: -+ --- -Identifier for certificate signature algorithm. We recommend using names found in Go Lang Crypto library. See https://github.com/golang/go/blob/go1.14/src/crypto/x509/x509.go#L337-L353. - -type: keyword - -example: SHA256-RSA - --- - -*`threat.enrichments.indicator.x509.subject.common_name`*:: -+ --- -List of common names (CN) of subject. - -type: keyword - -example: shared.global.example.net - --- - -*`threat.enrichments.indicator.x509.subject.country`*:: -+ --- -List of country (C) code - -type: keyword - -example: US - --- - -*`threat.enrichments.indicator.x509.subject.distinguished_name`*:: -+ --- -Distinguished name (DN) of the certificate subject entity. - -type: keyword - -example: C=US, ST=California, L=San Francisco, O=Example, Inc., CN=shared.global.example.net - --- - -*`threat.enrichments.indicator.x509.subject.locality`*:: -+ --- -List of locality names (L) - -type: keyword - -example: San Francisco - --- - -*`threat.enrichments.indicator.x509.subject.organization`*:: -+ --- -List of organizations (O) of subject. - -type: keyword - -example: Example, Inc. - --- - -*`threat.enrichments.indicator.x509.subject.organizational_unit`*:: -+ --- -List of organizational units (OU) of subject. - -type: keyword - --- - -*`threat.enrichments.indicator.x509.subject.state_or_province`*:: -+ --- -List of state or province names (ST, S, or P) - -type: keyword - -example: California - --- - -*`threat.enrichments.indicator.x509.version_number`*:: -+ --- -Version of x509 format. - -type: keyword - -example: 3 - --- - -*`threat.enrichments.matched.atomic`*:: -+ --- -Identifies the atomic indicator value that matched a local environment endpoint or network event. - -type: keyword - -example: bad-domain.com - --- - -*`threat.enrichments.matched.field`*:: -+ --- -Identifies the field of the atomic indicator that matched a local environment endpoint or network event. - -type: keyword - -example: file.hash.sha256 - --- - -*`threat.enrichments.matched.id`*:: -+ --- -Identifies the _id of the indicator document enriching the event. - -type: keyword - -example: ff93aee5-86a1-4a61-b0e6-0cdc313d01b5 - --- - -*`threat.enrichments.matched.index`*:: -+ --- -Identifies the _index of the indicator document enriching the event. - -type: keyword - -example: filebeat-8.0.0-2021.05.23-000011 - --- - -*`threat.enrichments.matched.type`*:: -+ --- -Identifies the type of match that caused the event to be enriched with the given indicator - -type: keyword - -example: indicator_match_rule - --- - -*`threat.framework`*:: -+ --- -Name of the threat framework used to further categorize and classify the tactic and technique of the reported threat. Framework classification can be provided by detecting systems, evaluated at ingest time, or retrospectively tagged to events. - -type: keyword - -example: MITRE ATT&CK - --- - -*`threat.group.alias`*:: -+ --- -The alias(es) of the group for a set of related intrusion activity that are tracked by a common name in the security community. -While not required, you can use a MITRE ATT&CK® group alias(es). - -type: keyword - -example: [ "Magecart Group 6" ] - --- - -*`threat.group.id`*:: -+ --- -The id of the group for a set of related intrusion activity that are tracked by a common name in the security community. -While not required, you can use a MITRE ATT&CK® group id. - -type: keyword - -example: G0037 - --- - -*`threat.group.name`*:: -+ --- -The name of the group for a set of related intrusion activity that are tracked by a common name in the security community. -While not required, you can use a MITRE ATT&CK® group name. - -type: keyword - -example: FIN6 - --- - -*`threat.group.reference`*:: -+ --- -The reference URL of the group for a set of related intrusion activity that are tracked by a common name in the security community. -While not required, you can use a MITRE ATT&CK® group reference URL. - -type: keyword - -example: https://attack.mitre.org/groups/G0037/ - --- - -*`threat.indicator.as.number`*:: -+ --- -Unique number allocated to the autonomous system. The autonomous system number (ASN) uniquely identifies each network on the Internet. - -type: long - -example: 15169 - --- - -*`threat.indicator.as.organization.name`*:: -+ --- -Organization name. - -type: keyword - -example: Google LLC - --- - -*`threat.indicator.as.organization.name.text`*:: -+ --- -type: match_only_text - --- - -*`threat.indicator.confidence`*:: -+ --- -Identifies the vendor-neutral confidence rating using the None/Low/Medium/High scale defined in Appendix A of the STIX 2.1 framework. Vendor-specific confidence scales may be added as custom fields. -Expected values are: - * Not Specified - * None - * Low - * Medium - * High - -type: keyword - -example: Medium - --- - -*`threat.indicator.description`*:: -+ --- -Describes the type of action conducted by the threat. - -type: keyword - -example: IP x.x.x.x was observed delivering the Angler EK. - --- - -*`threat.indicator.email.address`*:: -+ --- -Identifies a threat indicator as an email address (irrespective of direction). - -type: keyword - -example: phish@example.com - --- - -*`threat.indicator.file.accessed`*:: -+ --- -Last time the file was accessed. -Note that not all filesystems keep track of access time. - -type: date - --- - -*`threat.indicator.file.attributes`*:: -+ --- -Array of file attributes. -Attributes names will vary by platform. Here's a non-exhaustive list of values that are expected in this field: archive, compressed, directory, encrypted, execute, hidden, read, readonly, system, write. - -type: keyword - -example: ["readonly", "system"] - --- - -*`threat.indicator.file.code_signature.digest_algorithm`*:: -+ --- -The hashing algorithm used to sign the process. -This value can distinguish signatures when a file is signed multiple times by the same signer but with a different digest algorithm. - -type: keyword - -example: sha256 - --- - -*`threat.indicator.file.code_signature.exists`*:: -+ --- -Boolean to capture if a signature is present. - -type: boolean - -example: true - --- - -*`threat.indicator.file.code_signature.signing_id`*:: -+ --- -The identifier used to sign the process. -This is used to identify the application manufactured by a software vendor. The field is relevant to Apple *OS only. - -type: keyword - -example: com.apple.xpc.proxy - --- - -*`threat.indicator.file.code_signature.status`*:: -+ --- -Additional information about the certificate status. -This is useful for logging cryptographic errors with the certificate validity or trust status. Leave unpopulated if the validity or trust of the certificate was unchecked. - -type: keyword - -example: ERROR_UNTRUSTED_ROOT - --- - -*`threat.indicator.file.code_signature.subject_name`*:: -+ --- -Subject name of the code signer - -type: keyword - -example: Microsoft Corporation - --- - -*`threat.indicator.file.code_signature.team_id`*:: -+ --- -The team identifier used to sign the process. -This is used to identify the team or vendor of a software product. The field is relevant to Apple *OS only. - -type: keyword - -example: EQHXZ8M8AV - --- - -*`threat.indicator.file.code_signature.timestamp`*:: -+ --- -Date and time when the code signature was generated and signed. - -type: date - -example: 2021-01-01T12:10:30Z - --- - -*`threat.indicator.file.code_signature.trusted`*:: -+ --- -Stores the trust status of the certificate chain. -Validating the trust of the certificate chain may be complicated, and this field should only be populated by tools that actively check the status. - -type: boolean - -example: true - --- - -*`threat.indicator.file.code_signature.valid`*:: -+ --- -Boolean to capture if the digital signature is verified against the binary content. -Leave unpopulated if a certificate was unchecked. - -type: boolean - -example: true - --- - -*`threat.indicator.file.created`*:: -+ --- -File creation time. -Note that not all filesystems store the creation time. - -type: date - --- - -*`threat.indicator.file.ctime`*:: -+ --- -Last time the file attributes or metadata changed. -Note that changes to the file content will update `mtime`. This implies `ctime` will be adjusted at the same time, since `mtime` is an attribute of the file. - -type: date - --- - -*`threat.indicator.file.device`*:: -+ --- -Device that is the source of the file. - -type: keyword - -example: sda - --- - -*`threat.indicator.file.directory`*:: -+ --- -Directory where the file is located. It should include the drive letter, when appropriate. - -type: keyword - -example: /home/alice - --- - -*`threat.indicator.file.drive_letter`*:: -+ --- -Drive letter where the file is located. This field is only relevant on Windows. -The value should be uppercase, and not include the colon. - -type: keyword - -example: C - --- - -*`threat.indicator.file.elf.architecture`*:: -+ --- -Machine architecture of the ELF file. - -type: keyword - -example: x86-64 - --- - -*`threat.indicator.file.elf.byte_order`*:: -+ --- -Byte sequence of ELF file. - -type: keyword - -example: Little Endian - --- - -*`threat.indicator.file.elf.cpu_type`*:: -+ --- -CPU type of the ELF file. - -type: keyword - -example: Intel - --- - -*`threat.indicator.file.elf.creation_date`*:: -+ --- -Extracted when possible from the file's metadata. Indicates when it was built or compiled. It can also be faked by malware creators. - -type: date - --- - -*`threat.indicator.file.elf.exports`*:: -+ --- -List of exported element names and types. - -type: flattened - --- - -*`threat.indicator.file.elf.header.abi_version`*:: -+ --- -Version of the ELF Application Binary Interface (ABI). - -type: keyword - --- - -*`threat.indicator.file.elf.header.class`*:: -+ --- -Header class of the ELF file. - -type: keyword - --- - -*`threat.indicator.file.elf.header.data`*:: -+ --- -Data table of the ELF header. - -type: keyword - --- - -*`threat.indicator.file.elf.header.entrypoint`*:: -+ --- -Header entrypoint of the ELF file. - -type: long - -format: string - --- - -*`threat.indicator.file.elf.header.object_version`*:: -+ --- -"0x1" for original ELF files. - -type: keyword - --- - -*`threat.indicator.file.elf.header.os_abi`*:: -+ --- -Application Binary Interface (ABI) of the Linux OS. - -type: keyword - --- - -*`threat.indicator.file.elf.header.type`*:: -+ --- -Header type of the ELF file. - -type: keyword - --- - -*`threat.indicator.file.elf.header.version`*:: -+ --- -Version of the ELF header. - -type: keyword - --- - -*`threat.indicator.file.elf.imports`*:: -+ --- -List of imported element names and types. - -type: flattened - --- - -*`threat.indicator.file.elf.sections`*:: -+ --- -An array containing an object for each section of the ELF file. -The keys that should be present in these objects are defined by sub-fields underneath `elf.sections.*`. - -type: nested - --- - -*`threat.indicator.file.elf.sections.chi2`*:: -+ --- -Chi-square probability distribution of the section. - -type: long - -format: number - --- - -*`threat.indicator.file.elf.sections.entropy`*:: -+ --- -Shannon entropy calculation from the section. - -type: long - -format: number - --- - -*`threat.indicator.file.elf.sections.flags`*:: -+ --- -ELF Section List flags. - -type: keyword - --- - -*`threat.indicator.file.elf.sections.name`*:: -+ --- -ELF Section List name. - -type: keyword - --- - -*`threat.indicator.file.elf.sections.physical_offset`*:: -+ --- -ELF Section List offset. - -type: keyword - --- - -*`threat.indicator.file.elf.sections.physical_size`*:: -+ --- -ELF Section List physical size. - -type: long - -format: bytes - --- - -*`threat.indicator.file.elf.sections.type`*:: -+ --- -ELF Section List type. - -type: keyword - --- - -*`threat.indicator.file.elf.sections.virtual_address`*:: -+ --- -ELF Section List virtual address. - -type: long - -format: string - --- - -*`threat.indicator.file.elf.sections.virtual_size`*:: -+ --- -ELF Section List virtual size. - -type: long - -format: string - --- - -*`threat.indicator.file.elf.segments`*:: -+ --- -An array containing an object for each segment of the ELF file. -The keys that should be present in these objects are defined by sub-fields underneath `elf.segments.*`. - -type: nested - --- - -*`threat.indicator.file.elf.segments.sections`*:: -+ --- -ELF object segment sections. - -type: keyword - --- - -*`threat.indicator.file.elf.segments.type`*:: -+ --- -ELF object segment type. - -type: keyword - --- - -*`threat.indicator.file.elf.shared_libraries`*:: -+ --- -List of shared libraries used by this ELF object. - -type: keyword - --- - -*`threat.indicator.file.elf.telfhash`*:: -+ --- -telfhash symbol hash for ELF file. - -type: keyword - --- - -*`threat.indicator.file.extension`*:: -+ --- -File extension, excluding the leading dot. -Note that when the file name has multiple extensions (example.tar.gz), only the last one should be captured ("gz", not "tar.gz"). - -type: keyword - -example: png - --- - -*`threat.indicator.file.fork_name`*:: -+ --- -A fork is additional data associated with a filesystem object. -On Linux, a resource fork is used to store additional data with a filesystem object. A file always has at least one fork for the data portion, and additional forks may exist. -On NTFS, this is analogous to an Alternate Data Stream (ADS), and the default data stream for a file is just called $DATA. Zone.Identifier is commonly used by Windows to track contents downloaded from the Internet. An ADS is typically of the form: `C:\path\to\filename.extension:some_fork_name`, and `some_fork_name` is the value that should populate `fork_name`. `filename.extension` should populate `file.name`, and `extension` should populate `file.extension`. The full path, `file.path`, will include the fork name. - -type: keyword - -example: Zone.Identifer - --- - -*`threat.indicator.file.gid`*:: -+ --- -Primary group ID (GID) of the file. - -type: keyword - -example: 1001 - --- - -*`threat.indicator.file.group`*:: -+ --- -Primary group name of the file. - -type: keyword - -example: alice - --- - -*`threat.indicator.file.hash.md5`*:: -+ --- -MD5 hash. - -type: keyword - --- - -*`threat.indicator.file.hash.sha1`*:: -+ --- -SHA1 hash. - -type: keyword - --- - -*`threat.indicator.file.hash.sha256`*:: -+ --- -SHA256 hash. - -type: keyword - --- - -*`threat.indicator.file.hash.sha512`*:: -+ --- -SHA512 hash. - -type: keyword - --- - -*`threat.indicator.file.hash.ssdeep`*:: -+ --- -SSDEEP hash. - -type: keyword - --- - -*`threat.indicator.file.inode`*:: -+ --- -Inode representing the file in the filesystem. - -type: keyword - -example: 256383 - --- - -*`threat.indicator.file.mime_type`*:: -+ --- -MIME type should identify the format of the file or stream of bytes using https://www.iana.org/assignments/media-types/media-types.xhtml[IANA official types], where possible. When more than one type is applicable, the most specific type should be used. - -type: keyword - --- - -*`threat.indicator.file.mode`*:: -+ --- -Mode of the file in octal representation. - -type: keyword - -example: 0640 - --- - -*`threat.indicator.file.mtime`*:: -+ --- -Last time the file content was modified. - -type: date - --- - -*`threat.indicator.file.name`*:: -+ --- -Name of the file including the extension, without the directory. - -type: keyword - -example: example.png - --- - -*`threat.indicator.file.owner`*:: -+ --- -File owner's username. - -type: keyword - -example: alice - --- - -*`threat.indicator.file.path`*:: -+ --- -Full path to the file, including the file name. It should include the drive letter, when appropriate. - -type: keyword - -example: /home/alice/example.png - --- - -*`threat.indicator.file.path.text`*:: -+ --- -type: match_only_text - --- - -*`threat.indicator.file.pe.architecture`*:: -+ --- -CPU architecture target for the file. - -type: keyword - -example: x64 - --- - -*`threat.indicator.file.pe.company`*:: -+ --- -Internal company name of the file, provided at compile-time. - -type: keyword - -example: Microsoft Corporation - --- - -*`threat.indicator.file.pe.description`*:: -+ --- -Internal description of the file, provided at compile-time. - -type: keyword - -example: Paint - --- - -*`threat.indicator.file.pe.file_version`*:: -+ --- -Internal version of the file, provided at compile-time. - -type: keyword - -example: 6.3.9600.17415 - --- - -*`threat.indicator.file.pe.imphash`*:: -+ --- -A hash of the imports in a PE file. An imphash -- or import hash -- can be used to fingerprint binaries even after recompilation or other code-level transformations have occurred, which would change more traditional hash values. -Learn more at https://www.fireeye.com/blog/threat-research/2014/01/tracking-malware-import-hashing.html. - -type: keyword - -example: 0c6803c4e922103c4dca5963aad36ddf - --- - -*`threat.indicator.file.pe.original_file_name`*:: -+ --- -Internal name of the file, provided at compile-time. - -type: keyword - -example: MSPAINT.EXE - --- - -*`threat.indicator.file.pe.product`*:: -+ --- -Internal product name of the file, provided at compile-time. - -type: keyword - -example: Microsoft® Windows® Operating System - --- - -*`threat.indicator.file.size`*:: -+ --- -File size in bytes. -Only relevant when `file.type` is "file". - -type: long - -example: 16384 - --- - -*`threat.indicator.file.target_path`*:: -+ --- -Target path for symlinks. - -type: keyword - --- - -*`threat.indicator.file.target_path.text`*:: -+ --- -type: match_only_text - --- - -*`threat.indicator.file.type`*:: -+ --- -File type (file, dir, or symlink). - -type: keyword - -example: file - --- - -*`threat.indicator.file.uid`*:: -+ --- -The user ID (UID) or security identifier (SID) of the file owner. - -type: keyword - -example: 1001 - --- - -*`threat.indicator.file.x509.alternative_names`*:: -+ --- -List of subject alternative names (SAN). Name types vary by certificate authority and certificate type but commonly contain IP addresses, DNS names (and wildcards), and email addresses. - -type: keyword - -example: *.elastic.co - --- - -*`threat.indicator.file.x509.issuer.common_name`*:: -+ --- -List of common name (CN) of issuing certificate authority. - -type: keyword - -example: Example SHA2 High Assurance Server CA - --- - -*`threat.indicator.file.x509.issuer.country`*:: -+ --- -List of country (C) codes - -type: keyword - -example: US - --- - -*`threat.indicator.file.x509.issuer.distinguished_name`*:: -+ --- -Distinguished name (DN) of issuing certificate authority. - -type: keyword - -example: C=US, O=Example Inc, OU=www.example.com, CN=Example SHA2 High Assurance Server CA - --- - -*`threat.indicator.file.x509.issuer.locality`*:: -+ --- -List of locality names (L) - -type: keyword - -example: Mountain View - --- - -*`threat.indicator.file.x509.issuer.organization`*:: -+ --- -List of organizations (O) of issuing certificate authority. - -type: keyword - -example: Example Inc - --- - -*`threat.indicator.file.x509.issuer.organizational_unit`*:: -+ --- -List of organizational units (OU) of issuing certificate authority. - -type: keyword - -example: www.example.com - --- - -*`threat.indicator.file.x509.issuer.state_or_province`*:: -+ --- -List of state or province names (ST, S, or P) - -type: keyword - -example: California - --- - -*`threat.indicator.file.x509.not_after`*:: -+ --- -Time at which the certificate is no longer considered valid. - -type: date - -example: 2020-07-16 03:15:39+00:00 - --- - -*`threat.indicator.file.x509.not_before`*:: -+ --- -Time at which the certificate is first considered valid. - -type: date - -example: 2019-08-16 01:40:25+00:00 - --- - -*`threat.indicator.file.x509.public_key_algorithm`*:: -+ --- -Algorithm used to generate the public key. - -type: keyword - -example: RSA - --- - -*`threat.indicator.file.x509.public_key_curve`*:: -+ --- -The curve used by the elliptic curve public key algorithm. This is algorithm specific. - -type: keyword - -example: nistp521 - --- - -*`threat.indicator.file.x509.public_key_exponent`*:: -+ --- -Exponent used to derive the public key. This is algorithm specific. - -type: long - -example: 65537 - -Field is not indexed. - --- - -*`threat.indicator.file.x509.public_key_size`*:: -+ --- -The size of the public key space in bits. - -type: long - -example: 2048 - --- - -*`threat.indicator.file.x509.serial_number`*:: -+ --- -Unique serial number issued by the certificate authority. For consistency, if this value is alphanumeric, it should be formatted without colons and uppercase characters. - -type: keyword - -example: 55FBB9C7DEBF09809D12CCAA - --- - -*`threat.indicator.file.x509.signature_algorithm`*:: -+ --- -Identifier for certificate signature algorithm. We recommend using names found in Go Lang Crypto library. See https://github.com/golang/go/blob/go1.14/src/crypto/x509/x509.go#L337-L353. - -type: keyword - -example: SHA256-RSA - --- - -*`threat.indicator.file.x509.subject.common_name`*:: -+ --- -List of common names (CN) of subject. - -type: keyword - -example: shared.global.example.net - --- - -*`threat.indicator.file.x509.subject.country`*:: -+ --- -List of country (C) code - -type: keyword - -example: US - --- - -*`threat.indicator.file.x509.subject.distinguished_name`*:: -+ --- -Distinguished name (DN) of the certificate subject entity. - -type: keyword - -example: C=US, ST=California, L=San Francisco, O=Example, Inc., CN=shared.global.example.net - --- - -*`threat.indicator.file.x509.subject.locality`*:: -+ --- -List of locality names (L) - -type: keyword - -example: San Francisco - --- - -*`threat.indicator.file.x509.subject.organization`*:: -+ --- -List of organizations (O) of subject. - -type: keyword - -example: Example, Inc. - --- - -*`threat.indicator.file.x509.subject.organizational_unit`*:: -+ --- -List of organizational units (OU) of subject. - -type: keyword - --- - -*`threat.indicator.file.x509.subject.state_or_province`*:: -+ --- -List of state or province names (ST, S, or P) - -type: keyword - -example: California - --- - -*`threat.indicator.file.x509.version_number`*:: -+ --- -Version of x509 format. - -type: keyword - -example: 3 - --- - -*`threat.indicator.first_seen`*:: -+ --- -The date and time when intelligence source first reported sighting this indicator. - -type: date - -example: 2020-11-05T17:25:47.000Z - --- - -*`threat.indicator.geo.city_name`*:: -+ --- -City name. - -type: keyword - -example: Montreal - --- - -*`threat.indicator.geo.continent_code`*:: -+ --- -Two-letter code representing continent's name. - -type: keyword - -example: NA - --- - -*`threat.indicator.geo.continent_name`*:: -+ --- -Name of the continent. - -type: keyword - -example: North America - --- - -*`threat.indicator.geo.country_iso_code`*:: -+ --- -Country ISO code. - -type: keyword - -example: CA - --- - -*`threat.indicator.geo.country_name`*:: -+ --- -Country name. - -type: keyword - -example: Canada - --- - -*`threat.indicator.geo.location`*:: -+ --- -Longitude and latitude. - -type: geo_point - -example: { "lon": -73.614830, "lat": 45.505918 } - --- - -*`threat.indicator.geo.name`*:: -+ --- -User-defined description of a location, at the level of granularity they care about. -Could be the name of their data centers, the floor number, if this describes a local physical entity, city names. -Not typically used in automated geolocation. - -type: keyword - -example: boston-dc - --- - -*`threat.indicator.geo.postal_code`*:: -+ --- -Postal code associated with the location. -Values appropriate for this field may also be known as a postcode or ZIP code and will vary widely from country to country. - -type: keyword - -example: 94040 - --- - -*`threat.indicator.geo.region_iso_code`*:: -+ --- -Region ISO code. - -type: keyword - -example: CA-QC - --- - -*`threat.indicator.geo.region_name`*:: -+ --- -Region name. - -type: keyword - -example: Quebec - --- - -*`threat.indicator.geo.timezone`*:: -+ --- -The time zone of the location, such as IANA time zone name. - -type: keyword - -example: America/Argentina/Buenos_Aires - --- - -*`threat.indicator.ip`*:: -+ --- -Identifies a threat indicator as an IP address (irrespective of direction). - -type: ip - -example: 1.2.3.4 - --- - -*`threat.indicator.last_seen`*:: -+ --- -The date and time when intelligence source last reported sighting this indicator. - -type: date - -example: 2020-11-05T17:25:47.000Z - --- - -*`threat.indicator.marking.tlp`*:: -+ --- -Traffic Light Protocol sharing markings. -Recommended values are: - * WHITE - * GREEN - * AMBER - * RED - -type: keyword - -example: WHITE - --- - -*`threat.indicator.modified_at`*:: -+ --- -The date and time when intelligence source last modified information for this indicator. - -type: date - -example: 2020-11-05T17:25:47.000Z - --- - -*`threat.indicator.port`*:: -+ --- -Identifies a threat indicator as a port number (irrespective of direction). - -type: long - -example: 443 - --- - -*`threat.indicator.provider`*:: -+ --- -The name of the indicator's provider. - -type: keyword - -example: lrz_urlhaus - --- - -*`threat.indicator.reference`*:: -+ --- -Reference URL linking to additional information about this indicator. - -type: keyword - -example: https://system.example.com/indicator/0001234 - --- - -*`threat.indicator.registry.data.bytes`*:: -+ --- -Original bytes written with base64 encoding. -For Windows registry operations, such as SetValueEx and RegQueryValueEx, this corresponds to the data pointed by `lp_data`. This is optional but provides better recoverability and should be populated for REG_BINARY encoded values. - -type: keyword - -example: ZQBuAC0AVQBTAAAAZQBuAAAAAAA= - --- - -*`threat.indicator.registry.data.strings`*:: -+ --- -Content when writing string types. -Populated as an array when writing string data to the registry. For single string registry types (REG_SZ, REG_EXPAND_SZ), this should be an array with one string. For sequences of string with REG_MULTI_SZ, this array will be variable length. For numeric data, such as REG_DWORD and REG_QWORD, this should be populated with the decimal representation (e.g `"1"`). - -type: wildcard - -example: ["C:\rta\red_ttp\bin\myapp.exe"] - --- - -*`threat.indicator.registry.data.type`*:: -+ --- -Standard registry type for encoding contents - -type: keyword - -example: REG_SZ - --- - -*`threat.indicator.registry.hive`*:: -+ --- -Abbreviated name for the hive. - -type: keyword - -example: HKLM - --- - -*`threat.indicator.registry.key`*:: -+ --- -Hive-relative path of keys. - -type: keyword - -example: SOFTWARE\Microsoft\Windows NT\CurrentVersion\Image File Execution Options\winword.exe - --- - -*`threat.indicator.registry.path`*:: -+ --- -Full path, including hive, key and value - -type: keyword - -example: HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Image File Execution Options\winword.exe\Debugger - --- - -*`threat.indicator.registry.value`*:: -+ --- -Name of the value written. - -type: keyword - -example: Debugger - --- - -*`threat.indicator.scanner_stats`*:: -+ --- -Count of AV/EDR vendors that successfully detected malicious file or URL. - -type: long - -example: 4 - --- - -*`threat.indicator.sightings`*:: -+ --- -Number of times this indicator was observed conducting threat activity. - -type: long - -example: 20 - --- - -*`threat.indicator.type`*:: -+ --- -Type of indicator as represented by Cyber Observable in STIX 2.0. -Recommended values: - * autonomous-system - * artifact - * directory - * domain-name - * email-addr - * file - * ipv4-addr - * ipv6-addr - * mac-addr - * mutex - * port - * process - * software - * url - * user-account - * windows-registry-key - * x509-certificate - -type: keyword - -example: ipv4-addr - --- - -*`threat.indicator.url.domain`*:: -+ --- -Domain of the url, such as "www.elastic.co". -In some cases a URL may refer to an IP and/or port directly, without a domain name. In this case, the IP address would go to the `domain` field. -If the URL contains a literal IPv6 address enclosed by `[` and `]` (IETF RFC 2732), the `[` and `]` characters should also be captured in the `domain` field. - -type: keyword - -example: www.elastic.co - --- - -*`threat.indicator.url.extension`*:: -+ --- -The field contains the file extension from the original request url, excluding the leading dot. -The file extension is only set if it exists, as not every url has a file extension. -The leading period must not be included. For example, the value must be "png", not ".png". -Note that when the file name has multiple extensions (example.tar.gz), only the last one should be captured ("gz", not "tar.gz"). - -type: keyword - -example: png - --- - -*`threat.indicator.url.fragment`*:: -+ --- -Portion of the url after the `#`, such as "top". -The `#` is not part of the fragment. - -type: keyword - --- - -*`threat.indicator.url.full`*:: -+ --- -If full URLs are important to your use case, they should be stored in `url.full`, whether this field is reconstructed or present in the event source. - -type: wildcard - -example: https://www.elastic.co:443/search?q=elasticsearch#top - --- - -*`threat.indicator.url.full.text`*:: -+ --- -type: match_only_text - --- - -*`threat.indicator.url.original`*:: -+ --- -Unmodified original url as seen in the event source. -Note that in network monitoring, the observed URL may be a full URL, whereas in access logs, the URL is often just represented as a path. -This field is meant to represent the URL as it was observed, complete or not. - -type: wildcard - -example: https://www.elastic.co:443/search?q=elasticsearch#top or /search?q=elasticsearch - --- - -*`threat.indicator.url.original.text`*:: -+ --- -type: match_only_text - --- - -*`threat.indicator.url.password`*:: -+ --- -Password of the request. - -type: keyword - --- - -*`threat.indicator.url.path`*:: -+ --- -Path of the request, such as "/search". - -type: wildcard - --- - -*`threat.indicator.url.port`*:: -+ --- -Port of the request, such as 443. - -type: long - -example: 443 - -format: string - --- - -*`threat.indicator.url.query`*:: -+ --- -The query field describes the query string of the request, such as "q=elasticsearch". -The `?` is excluded from the query string. If a URL contains no `?`, there is no query field. If there is a `?` but no query, the query field exists with an empty string. The `exists` query can be used to differentiate between the two cases. - -type: keyword - --- - -*`threat.indicator.url.registered_domain`*:: -+ --- -The highest registered url domain, stripped of the subdomain. -For example, the registered domain for "foo.example.com" is "example.com". -This value can be determined precisely with a list like the public suffix list (http://publicsuffix.org). Trying to approximate this by simply taking the last two labels will not work well for TLDs such as "co.uk". - -type: keyword - -example: example.com - --- - -*`threat.indicator.url.scheme`*:: -+ --- -Scheme of the request, such as "https". -Note: The `:` is not part of the scheme. - -type: keyword - -example: https - --- - -*`threat.indicator.url.subdomain`*:: -+ --- -The subdomain portion of a fully qualified domain name includes all of the names except the host name under the registered_domain. In a partially qualified domain, or if the the qualification level of the full name cannot be determined, subdomain contains all of the names below the registered domain. -For example the subdomain portion of "www.east.mydomain.co.uk" is "east". If the domain has multiple levels of subdomain, such as "sub2.sub1.example.com", the subdomain field should contain "sub2.sub1", with no trailing period. - -type: keyword - -example: east - --- - -*`threat.indicator.url.top_level_domain`*:: -+ --- -The effective top level domain (eTLD), also known as the domain suffix, is the last part of the domain name. For example, the top level domain for example.com is "com". -This value can be determined precisely with a list like the public suffix list (http://publicsuffix.org). Trying to approximate this by simply taking the last label will not work well for effective TLDs such as "co.uk". - -type: keyword - -example: co.uk - --- - -*`threat.indicator.url.username`*:: -+ --- -Username of the request. - -type: keyword - --- - -*`threat.indicator.x509.alternative_names`*:: -+ --- -List of subject alternative names (SAN). Name types vary by certificate authority and certificate type but commonly contain IP addresses, DNS names (and wildcards), and email addresses. - -type: keyword - -example: *.elastic.co - --- - -*`threat.indicator.x509.issuer.common_name`*:: -+ --- -List of common name (CN) of issuing certificate authority. - -type: keyword - -example: Example SHA2 High Assurance Server CA - --- - -*`threat.indicator.x509.issuer.country`*:: -+ --- -List of country (C) codes - -type: keyword - -example: US - --- - -*`threat.indicator.x509.issuer.distinguished_name`*:: -+ --- -Distinguished name (DN) of issuing certificate authority. - -type: keyword - -example: C=US, O=Example Inc, OU=www.example.com, CN=Example SHA2 High Assurance Server CA - --- - -*`threat.indicator.x509.issuer.locality`*:: -+ --- -List of locality names (L) - -type: keyword - -example: Mountain View - --- - -*`threat.indicator.x509.issuer.organization`*:: -+ --- -List of organizations (O) of issuing certificate authority. - -type: keyword - -example: Example Inc - --- - -*`threat.indicator.x509.issuer.organizational_unit`*:: -+ --- -List of organizational units (OU) of issuing certificate authority. - -type: keyword - -example: www.example.com - --- - -*`threat.indicator.x509.issuer.state_or_province`*:: -+ --- -List of state or province names (ST, S, or P) - -type: keyword - -example: California - --- - -*`threat.indicator.x509.not_after`*:: -+ --- -Time at which the certificate is no longer considered valid. - -type: date - -example: 2020-07-16 03:15:39+00:00 - --- - -*`threat.indicator.x509.not_before`*:: -+ --- -Time at which the certificate is first considered valid. - -type: date - -example: 2019-08-16 01:40:25+00:00 - --- - -*`threat.indicator.x509.public_key_algorithm`*:: -+ --- -Algorithm used to generate the public key. - -type: keyword - -example: RSA - --- - -*`threat.indicator.x509.public_key_curve`*:: -+ --- -The curve used by the elliptic curve public key algorithm. This is algorithm specific. - -type: keyword - -example: nistp521 - --- - -*`threat.indicator.x509.public_key_exponent`*:: -+ --- -Exponent used to derive the public key. This is algorithm specific. - -type: long - -example: 65537 - -Field is not indexed. - --- - -*`threat.indicator.x509.public_key_size`*:: -+ --- -The size of the public key space in bits. - -type: long - -example: 2048 - --- - -*`threat.indicator.x509.serial_number`*:: -+ --- -Unique serial number issued by the certificate authority. For consistency, if this value is alphanumeric, it should be formatted without colons and uppercase characters. - -type: keyword - -example: 55FBB9C7DEBF09809D12CCAA - --- - -*`threat.indicator.x509.signature_algorithm`*:: -+ --- -Identifier for certificate signature algorithm. We recommend using names found in Go Lang Crypto library. See https://github.com/golang/go/blob/go1.14/src/crypto/x509/x509.go#L337-L353. - -type: keyword - -example: SHA256-RSA - --- - -*`threat.indicator.x509.subject.common_name`*:: -+ --- -List of common names (CN) of subject. - -type: keyword - -example: shared.global.example.net - --- - -*`threat.indicator.x509.subject.country`*:: -+ --- -List of country (C) code - -type: keyword - -example: US - --- - -*`threat.indicator.x509.subject.distinguished_name`*:: -+ --- -Distinguished name (DN) of the certificate subject entity. - -type: keyword - -example: C=US, ST=California, L=San Francisco, O=Example, Inc., CN=shared.global.example.net - --- - -*`threat.indicator.x509.subject.locality`*:: -+ --- -List of locality names (L) - -type: keyword - -example: San Francisco - --- - -*`threat.indicator.x509.subject.organization`*:: -+ --- -List of organizations (O) of subject. - -type: keyword - -example: Example, Inc. - --- - -*`threat.indicator.x509.subject.organizational_unit`*:: -+ --- -List of organizational units (OU) of subject. - -type: keyword - --- - -*`threat.indicator.x509.subject.state_or_province`*:: -+ --- -List of state or province names (ST, S, or P) - -type: keyword - -example: California - --- - -*`threat.indicator.x509.version_number`*:: -+ --- -Version of x509 format. - -type: keyword - -example: 3 - --- - -*`threat.software.alias`*:: -+ --- -The alias(es) of the software for a set of related intrusion activity that are tracked by a common name in the security community. -While not required, you can use a MITRE ATT&CK® associated software description. - -type: keyword - -example: [ "X-Agent" ] - --- - -*`threat.software.id`*:: -+ --- -The id of the software used by this threat to conduct behavior commonly modeled using MITRE ATT&CK®. -While not required, you can use a MITRE ATT&CK® software id. - -type: keyword - -example: S0552 - --- - -*`threat.software.name`*:: -+ --- -The name of the software used by this threat to conduct behavior commonly modeled using MITRE ATT&CK®. -While not required, you can use a MITRE ATT&CK® software name. - -type: keyword - -example: AdFind - --- - -*`threat.software.platforms`*:: -+ --- -The platforms of the software used by this threat to conduct behavior commonly modeled using MITRE ATT&CK®. -Recommended Values: - * AWS - * Azure - * Azure AD - * GCP - * Linux - * macOS - * Network - * Office 365 - * SaaS - * Windows - -While not required, you can use a MITRE ATT&CK® software platforms. - -type: keyword - -example: [ "Windows" ] - --- - -*`threat.software.reference`*:: -+ --- -The reference URL of the software used by this threat to conduct behavior commonly modeled using MITRE ATT&CK®. -While not required, you can use a MITRE ATT&CK® software reference URL. - -type: keyword - -example: https://attack.mitre.org/software/S0552/ - --- - -*`threat.software.type`*:: -+ --- -The type of software used by this threat to conduct behavior commonly modeled using MITRE ATT&CK®. -Recommended values - * Malware - * Tool - - While not required, you can use a MITRE ATT&CK® software type. - -type: keyword - -example: Tool - --- - -*`threat.tactic.id`*:: -+ --- -The id of tactic used by this threat. You can use a MITRE ATT&CK® tactic, for example. (ex. https://attack.mitre.org/tactics/TA0002/ ) - -type: keyword - -example: TA0002 - --- - -*`threat.tactic.name`*:: -+ --- -Name of the type of tactic used by this threat. You can use a MITRE ATT&CK® tactic, for example. (ex. https://attack.mitre.org/tactics/TA0002/) - -type: keyword - -example: Execution - --- - -*`threat.tactic.reference`*:: -+ --- -The reference url of tactic used by this threat. You can use a MITRE ATT&CK® tactic, for example. (ex. https://attack.mitre.org/tactics/TA0002/ ) - -type: keyword - -example: https://attack.mitre.org/tactics/TA0002/ - --- - -*`threat.technique.id`*:: -+ --- -The id of technique used by this threat. You can use a MITRE ATT&CK® technique, for example. (ex. https://attack.mitre.org/techniques/T1059/) - -type: keyword - -example: T1059 - --- - -*`threat.technique.name`*:: -+ --- -The name of technique used by this threat. You can use a MITRE ATT&CK® technique, for example. (ex. https://attack.mitre.org/techniques/T1059/) - -type: keyword - -example: Command and Scripting Interpreter - --- - -*`threat.technique.name.text`*:: -+ --- -type: match_only_text - --- - -*`threat.technique.reference`*:: -+ --- -The reference url of technique used by this threat. You can use a MITRE ATT&CK® technique, for example. (ex. https://attack.mitre.org/techniques/T1059/) - -type: keyword - -example: https://attack.mitre.org/techniques/T1059/ - --- - -*`threat.technique.subtechnique.id`*:: -+ --- -The full id of subtechnique used by this threat. You can use a MITRE ATT&CK® subtechnique, for example. (ex. https://attack.mitre.org/techniques/T1059/001/) - -type: keyword - -example: T1059.001 - --- - -*`threat.technique.subtechnique.name`*:: -+ --- -The name of subtechnique used by this threat. You can use a MITRE ATT&CK® subtechnique, for example. (ex. https://attack.mitre.org/techniques/T1059/001/) - -type: keyword - -example: PowerShell - --- - -*`threat.technique.subtechnique.name.text`*:: -+ --- -type: match_only_text - --- - -*`threat.technique.subtechnique.reference`*:: -+ --- -The reference url of subtechnique used by this threat. You can use a MITRE ATT&CK® subtechnique, for example. (ex. https://attack.mitre.org/techniques/T1059/001/) - -type: keyword - -example: https://attack.mitre.org/techniques/T1059/001/ - --- - -[float] -=== tls - -Fields related to a TLS connection. These fields focus on the TLS protocol itself and intentionally avoids in-depth analysis of the related x.509 certificate files. - - -*`tls.cipher`*:: -+ --- -String indicating the cipher used during the current connection. - -type: keyword - -example: TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 - --- - -*`tls.client.certificate`*:: -+ --- -PEM-encoded stand-alone certificate offered by the client. This is usually mutually-exclusive of `client.certificate_chain` since this value also exists in that list. - -type: keyword - -example: MII... - --- - -*`tls.client.certificate_chain`*:: -+ --- -Array of PEM-encoded certificates that make up the certificate chain offered by the client. This is usually mutually-exclusive of `client.certificate` since that value should be the first certificate in the chain. - -type: keyword - -example: ["MII...", "MII..."] - --- - -*`tls.client.hash.md5`*:: -+ --- -Certificate fingerprint using the MD5 digest of DER-encoded version of certificate offered by the client. For consistency with other hash values, this value should be formatted as an uppercase hash. - -type: keyword - -example: 0F76C7F2C55BFD7D8E8B8F4BFBF0C9EC - --- - -*`tls.client.hash.sha1`*:: -+ --- -Certificate fingerprint using the SHA1 digest of DER-encoded version of certificate offered by the client. For consistency with other hash values, this value should be formatted as an uppercase hash. - -type: keyword - -example: 9E393D93138888D288266C2D915214D1D1CCEB2A - --- - -*`tls.client.hash.sha256`*:: -+ --- -Certificate fingerprint using the SHA256 digest of DER-encoded version of certificate offered by the client. For consistency with other hash values, this value should be formatted as an uppercase hash. - -type: keyword - -example: 0687F666A054EF17A08E2F2162EAB4CBC0D265E1D7875BE74BF3C712CA92DAF0 - --- - -*`tls.client.issuer`*:: -+ --- -Distinguished name of subject of the issuer of the x.509 certificate presented by the client. - -type: keyword - -example: CN=Example Root CA, OU=Infrastructure Team, DC=example, DC=com - --- - -*`tls.client.ja3`*:: -+ --- -A hash that identifies clients based on how they perform an SSL/TLS handshake. - -type: keyword - -example: d4e5b18d6b55c71272893221c96ba240 - --- - -*`tls.client.not_after`*:: -+ --- -Date/Time indicating when client certificate is no longer considered valid. - -type: date - -example: 2021-01-01T00:00:00.000Z - --- - -*`tls.client.not_before`*:: -+ --- -Date/Time indicating when client certificate is first considered valid. - -type: date - -example: 1970-01-01T00:00:00.000Z - --- - -*`tls.client.server_name`*:: -+ --- -Also called an SNI, this tells the server which hostname to which the client is attempting to connect to. When this value is available, it should get copied to `destination.domain`. - -type: keyword - -example: www.elastic.co - --- - -*`tls.client.subject`*:: -+ --- -Distinguished name of subject of the x.509 certificate presented by the client. - -type: keyword - -example: CN=myclient, OU=Documentation Team, DC=example, DC=com - --- - -*`tls.client.supported_ciphers`*:: -+ --- -Array of ciphers offered by the client during the client hello. - -type: keyword - -example: ["TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384", "TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384", "..."] - --- - -*`tls.client.x509.alternative_names`*:: -+ --- -List of subject alternative names (SAN). Name types vary by certificate authority and certificate type but commonly contain IP addresses, DNS names (and wildcards), and email addresses. - -type: keyword - -example: *.elastic.co - --- - -*`tls.client.x509.issuer.common_name`*:: -+ --- -List of common name (CN) of issuing certificate authority. - -type: keyword - -example: Example SHA2 High Assurance Server CA - --- - -*`tls.client.x509.issuer.country`*:: -+ --- -List of country (C) codes - -type: keyword - -example: US - --- - -*`tls.client.x509.issuer.distinguished_name`*:: -+ --- -Distinguished name (DN) of issuing certificate authority. - -type: keyword - -example: C=US, O=Example Inc, OU=www.example.com, CN=Example SHA2 High Assurance Server CA - --- - -*`tls.client.x509.issuer.locality`*:: -+ --- -List of locality names (L) - -type: keyword - -example: Mountain View - --- - -*`tls.client.x509.issuer.organization`*:: -+ --- -List of organizations (O) of issuing certificate authority. - -type: keyword - -example: Example Inc - --- - -*`tls.client.x509.issuer.organizational_unit`*:: -+ --- -List of organizational units (OU) of issuing certificate authority. - -type: keyword - -example: www.example.com - --- - -*`tls.client.x509.issuer.state_or_province`*:: -+ --- -List of state or province names (ST, S, or P) - -type: keyword - -example: California - --- - -*`tls.client.x509.not_after`*:: -+ --- -Time at which the certificate is no longer considered valid. - -type: date - -example: 2020-07-16 03:15:39+00:00 - --- - -*`tls.client.x509.not_before`*:: -+ --- -Time at which the certificate is first considered valid. - -type: date - -example: 2019-08-16 01:40:25+00:00 - --- - -*`tls.client.x509.public_key_algorithm`*:: -+ --- -Algorithm used to generate the public key. - -type: keyword - -example: RSA - --- - -*`tls.client.x509.public_key_curve`*:: -+ --- -The curve used by the elliptic curve public key algorithm. This is algorithm specific. - -type: keyword - -example: nistp521 - --- - -*`tls.client.x509.public_key_exponent`*:: -+ --- -Exponent used to derive the public key. This is algorithm specific. - -type: long - -example: 65537 - -Field is not indexed. - --- - -*`tls.client.x509.public_key_size`*:: -+ --- -The size of the public key space in bits. - -type: long - -example: 2048 - --- - -*`tls.client.x509.serial_number`*:: -+ --- -Unique serial number issued by the certificate authority. For consistency, if this value is alphanumeric, it should be formatted without colons and uppercase characters. - -type: keyword - -example: 55FBB9C7DEBF09809D12CCAA - --- - -*`tls.client.x509.signature_algorithm`*:: -+ --- -Identifier for certificate signature algorithm. We recommend using names found in Go Lang Crypto library. See https://github.com/golang/go/blob/go1.14/src/crypto/x509/x509.go#L337-L353. - -type: keyword - -example: SHA256-RSA - --- - -*`tls.client.x509.subject.common_name`*:: -+ --- -List of common names (CN) of subject. - -type: keyword - -example: shared.global.example.net - --- - -*`tls.client.x509.subject.country`*:: -+ --- -List of country (C) code - -type: keyword - -example: US - --- - -*`tls.client.x509.subject.distinguished_name`*:: -+ --- -Distinguished name (DN) of the certificate subject entity. - -type: keyword - -example: C=US, ST=California, L=San Francisco, O=Example, Inc., CN=shared.global.example.net - --- - -*`tls.client.x509.subject.locality`*:: -+ --- -List of locality names (L) - -type: keyword - -example: San Francisco - --- - -*`tls.client.x509.subject.organization`*:: -+ --- -List of organizations (O) of subject. - -type: keyword - -example: Example, Inc. - --- - -*`tls.client.x509.subject.organizational_unit`*:: -+ --- -List of organizational units (OU) of subject. - -type: keyword - --- - -*`tls.client.x509.subject.state_or_province`*:: -+ --- -List of state or province names (ST, S, or P) - -type: keyword - -example: California - --- - -*`tls.client.x509.version_number`*:: -+ --- -Version of x509 format. - -type: keyword - -example: 3 - --- - -*`tls.curve`*:: -+ --- -String indicating the curve used for the given cipher, when applicable. - -type: keyword - -example: secp256r1 - --- - -*`tls.established`*:: -+ --- -Boolean flag indicating if the TLS negotiation was successful and transitioned to an encrypted tunnel. - -type: boolean - --- - -*`tls.next_protocol`*:: -+ --- -String indicating the protocol being tunneled. Per the values in the IANA registry (https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids), this string should be lower case. - -type: keyword - -example: http/1.1 - --- - -*`tls.resumed`*:: -+ --- -Boolean flag indicating if this TLS connection was resumed from an existing TLS negotiation. - -type: boolean - --- - -*`tls.server.certificate`*:: -+ --- -PEM-encoded stand-alone certificate offered by the server. This is usually mutually-exclusive of `server.certificate_chain` since this value also exists in that list. - -type: keyword - -example: MII... - --- - -*`tls.server.certificate_chain`*:: -+ --- -Array of PEM-encoded certificates that make up the certificate chain offered by the server. This is usually mutually-exclusive of `server.certificate` since that value should be the first certificate in the chain. - -type: keyword - -example: ["MII...", "MII..."] - --- - -*`tls.server.hash.md5`*:: -+ --- -Certificate fingerprint using the MD5 digest of DER-encoded version of certificate offered by the server. For consistency with other hash values, this value should be formatted as an uppercase hash. - -type: keyword - -example: 0F76C7F2C55BFD7D8E8B8F4BFBF0C9EC - --- - -*`tls.server.hash.sha1`*:: -+ --- -Certificate fingerprint using the SHA1 digest of DER-encoded version of certificate offered by the server. For consistency with other hash values, this value should be formatted as an uppercase hash. - -type: keyword - -example: 9E393D93138888D288266C2D915214D1D1CCEB2A - --- - -*`tls.server.hash.sha256`*:: -+ --- -Certificate fingerprint using the SHA256 digest of DER-encoded version of certificate offered by the server. For consistency with other hash values, this value should be formatted as an uppercase hash. - -type: keyword - -example: 0687F666A054EF17A08E2F2162EAB4CBC0D265E1D7875BE74BF3C712CA92DAF0 - --- - -*`tls.server.issuer`*:: -+ --- -Subject of the issuer of the x.509 certificate presented by the server. - -type: keyword - -example: CN=Example Root CA, OU=Infrastructure Team, DC=example, DC=com - --- - -*`tls.server.ja3s`*:: -+ --- -A hash that identifies servers based on how they perform an SSL/TLS handshake. - -type: keyword - -example: 394441ab65754e2207b1e1b457b3641d - --- - -*`tls.server.not_after`*:: -+ --- -Timestamp indicating when server certificate is no longer considered valid. - -type: date - -example: 2021-01-01T00:00:00.000Z - --- - -*`tls.server.not_before`*:: -+ --- -Timestamp indicating when server certificate is first considered valid. - -type: date - -example: 1970-01-01T00:00:00.000Z - --- - -*`tls.server.subject`*:: -+ --- -Subject of the x.509 certificate presented by the server. - -type: keyword - -example: CN=www.example.com, OU=Infrastructure Team, DC=example, DC=com - --- - -*`tls.server.x509.alternative_names`*:: -+ --- -List of subject alternative names (SAN). Name types vary by certificate authority and certificate type but commonly contain IP addresses, DNS names (and wildcards), and email addresses. - -type: keyword - -example: *.elastic.co - --- - -*`tls.server.x509.issuer.common_name`*:: -+ --- -List of common name (CN) of issuing certificate authority. - -type: keyword - -example: Example SHA2 High Assurance Server CA - --- - -*`tls.server.x509.issuer.country`*:: -+ --- -List of country (C) codes - -type: keyword - -example: US - --- - -*`tls.server.x509.issuer.distinguished_name`*:: -+ --- -Distinguished name (DN) of issuing certificate authority. - -type: keyword - -example: C=US, O=Example Inc, OU=www.example.com, CN=Example SHA2 High Assurance Server CA - --- - -*`tls.server.x509.issuer.locality`*:: -+ --- -List of locality names (L) - -type: keyword - -example: Mountain View - --- - -*`tls.server.x509.issuer.organization`*:: -+ --- -List of organizations (O) of issuing certificate authority. - -type: keyword - -example: Example Inc - --- - -*`tls.server.x509.issuer.organizational_unit`*:: -+ --- -List of organizational units (OU) of issuing certificate authority. - -type: keyword - -example: www.example.com - --- - -*`tls.server.x509.issuer.state_or_province`*:: -+ --- -List of state or province names (ST, S, or P) - -type: keyword - -example: California - --- - -*`tls.server.x509.not_after`*:: -+ --- -Time at which the certificate is no longer considered valid. - -type: date - -example: 2020-07-16 03:15:39+00:00 - --- - -*`tls.server.x509.not_before`*:: -+ --- -Time at which the certificate is first considered valid. - -type: date - -example: 2019-08-16 01:40:25+00:00 - --- - -*`tls.server.x509.public_key_algorithm`*:: -+ --- -Algorithm used to generate the public key. - -type: keyword - -example: RSA - --- - -*`tls.server.x509.public_key_curve`*:: -+ --- -The curve used by the elliptic curve public key algorithm. This is algorithm specific. - -type: keyword - -example: nistp521 - --- - -*`tls.server.x509.public_key_exponent`*:: -+ --- -Exponent used to derive the public key. This is algorithm specific. - -type: long - -example: 65537 - -Field is not indexed. - --- - -*`tls.server.x509.public_key_size`*:: -+ --- -The size of the public key space in bits. - -type: long - -example: 2048 - --- - -*`tls.server.x509.serial_number`*:: -+ --- -Unique serial number issued by the certificate authority. For consistency, if this value is alphanumeric, it should be formatted without colons and uppercase characters. - -type: keyword - -example: 55FBB9C7DEBF09809D12CCAA - --- - -*`tls.server.x509.signature_algorithm`*:: -+ --- -Identifier for certificate signature algorithm. We recommend using names found in Go Lang Crypto library. See https://github.com/golang/go/blob/go1.14/src/crypto/x509/x509.go#L337-L353. - -type: keyword - -example: SHA256-RSA - --- - -*`tls.server.x509.subject.common_name`*:: -+ --- -List of common names (CN) of subject. - -type: keyword - -example: shared.global.example.net - --- - -*`tls.server.x509.subject.country`*:: -+ --- -List of country (C) code - -type: keyword - -example: US - --- - -*`tls.server.x509.subject.distinguished_name`*:: -+ --- -Distinguished name (DN) of the certificate subject entity. - -type: keyword - -example: C=US, ST=California, L=San Francisco, O=Example, Inc., CN=shared.global.example.net - --- - -*`tls.server.x509.subject.locality`*:: -+ --- -List of locality names (L) - -type: keyword - -example: San Francisco - --- - -*`tls.server.x509.subject.organization`*:: -+ --- -List of organizations (O) of subject. - -type: keyword - -example: Example, Inc. - --- - -*`tls.server.x509.subject.organizational_unit`*:: -+ --- -List of organizational units (OU) of subject. - -type: keyword - --- - -*`tls.server.x509.subject.state_or_province`*:: -+ --- -List of state or province names (ST, S, or P) - -type: keyword - -example: California - --- - -*`tls.server.x509.version_number`*:: -+ --- -Version of x509 format. - -type: keyword - -example: 3 - --- - -*`tls.version`*:: -+ --- -Numeric part of the version parsed from the original string. - -type: keyword - -example: 1.2 - --- - -*`tls.version_protocol`*:: -+ --- -Normalized lowercase protocol name parsed from original string. - -type: keyword - -example: tls - --- - -*`span.id`*:: -+ --- -Unique identifier of the span within the scope of its trace. -A span represents an operation within a transaction, such as a request to another service, or a database query. - -type: keyword - -example: 3ff9a8981b7ccd5a - --- - -*`trace.id`*:: -+ --- -Unique identifier of the trace. -A trace groups multiple events like transactions that belong together. For example, a user request handled by multiple inter-connected services. - -type: keyword - -example: 4bf92f3577b34da6a3ce929d0e0e4736 - --- - -*`transaction.id`*:: -+ --- -Unique identifier of the transaction within the scope of its trace. -A transaction is the highest level of work measured within a service, such as a request to a server. - -type: keyword - -example: 00f067aa0ba902b7 - --- - -[float] -=== url - -URL fields provide support for complete or partial URLs, and supports the breaking down into scheme, domain, path, and so on. - - -*`url.domain`*:: -+ --- -Domain of the url, such as "www.elastic.co". -In some cases a URL may refer to an IP and/or port directly, without a domain name. In this case, the IP address would go to the `domain` field. -If the URL contains a literal IPv6 address enclosed by `[` and `]` (IETF RFC 2732), the `[` and `]` characters should also be captured in the `domain` field. - -type: keyword - -example: www.elastic.co - --- - -*`url.extension`*:: -+ --- -The field contains the file extension from the original request url, excluding the leading dot. -The file extension is only set if it exists, as not every url has a file extension. -The leading period must not be included. For example, the value must be "png", not ".png". -Note that when the file name has multiple extensions (example.tar.gz), only the last one should be captured ("gz", not "tar.gz"). - -type: keyword - -example: png - --- - -*`url.fragment`*:: -+ --- -Portion of the url after the `#`, such as "top". -The `#` is not part of the fragment. - -type: keyword - --- - -*`url.full`*:: -+ --- -If full URLs are important to your use case, they should be stored in `url.full`, whether this field is reconstructed or present in the event source. - -type: wildcard - -example: https://www.elastic.co:443/search?q=elasticsearch#top - --- - -*`url.full.text`*:: -+ --- -type: match_only_text - --- - -*`url.original`*:: -+ --- -Unmodified original url as seen in the event source. -Note that in network monitoring, the observed URL may be a full URL, whereas in access logs, the URL is often just represented as a path. -This field is meant to represent the URL as it was observed, complete or not. - -type: wildcard - -example: https://www.elastic.co:443/search?q=elasticsearch#top or /search?q=elasticsearch - --- - -*`url.original.text`*:: -+ --- -type: match_only_text - --- - -*`url.password`*:: -+ --- -Password of the request. - -type: keyword - --- - -*`url.path`*:: -+ --- -Path of the request, such as "/search". - -type: wildcard - --- - -*`url.port`*:: -+ --- -Port of the request, such as 443. - -type: long - -example: 443 - -format: string - --- - -*`url.query`*:: -+ --- -The query field describes the query string of the request, such as "q=elasticsearch". -The `?` is excluded from the query string. If a URL contains no `?`, there is no query field. If there is a `?` but no query, the query field exists with an empty string. The `exists` query can be used to differentiate between the two cases. - -type: keyword - --- - -*`url.registered_domain`*:: -+ --- -The highest registered url domain, stripped of the subdomain. -For example, the registered domain for "foo.example.com" is "example.com". -This value can be determined precisely with a list like the public suffix list (http://publicsuffix.org). Trying to approximate this by simply taking the last two labels will not work well for TLDs such as "co.uk". - -type: keyword - -example: example.com - --- - -*`url.scheme`*:: -+ --- -Scheme of the request, such as "https". -Note: The `:` is not part of the scheme. - -type: keyword - -example: https - --- - -*`url.subdomain`*:: -+ --- -The subdomain portion of a fully qualified domain name includes all of the names except the host name under the registered_domain. In a partially qualified domain, or if the the qualification level of the full name cannot be determined, subdomain contains all of the names below the registered domain. -For example the subdomain portion of "www.east.mydomain.co.uk" is "east". If the domain has multiple levels of subdomain, such as "sub2.sub1.example.com", the subdomain field should contain "sub2.sub1", with no trailing period. - -type: keyword - -example: east - --- - -*`url.top_level_domain`*:: -+ --- -The effective top level domain (eTLD), also known as the domain suffix, is the last part of the domain name. For example, the top level domain for example.com is "com". -This value can be determined precisely with a list like the public suffix list (http://publicsuffix.org). Trying to approximate this by simply taking the last label will not work well for effective TLDs such as "co.uk". - -type: keyword - -example: co.uk - --- - -*`url.username`*:: -+ --- -Username of the request. - -type: keyword - --- - -[float] -=== user - -The user fields describe information about the user that is relevant to the event. -Fields can have one entry or multiple entries. If a user has more than one id, provide an array that includes all of them. - - -*`user.changes.domain`*:: -+ --- -Name of the directory the user is a member of. -For example, an LDAP or Active Directory domain name. - -type: keyword - --- - -*`user.changes.email`*:: -+ --- -User email address. - -type: keyword - --- - -*`user.changes.full_name`*:: -+ --- -User's full name, if available. - -type: keyword - -example: Albert Einstein - --- - -*`user.changes.full_name.text`*:: -+ --- -type: match_only_text - --- - -*`user.changes.group.domain`*:: -+ --- -Name of the directory the group is a member of. -For example, an LDAP or Active Directory domain name. - -type: keyword - --- - -*`user.changes.group.id`*:: -+ --- -Unique identifier for the group on the system/platform. - -type: keyword - --- - -*`user.changes.group.name`*:: -+ --- -Name of the group. - -type: keyword - --- - -*`user.changes.hash`*:: -+ --- -Unique user hash to correlate information for a user in anonymized form. -Useful if `user.id` or `user.name` contain confidential information and cannot be used. - -type: keyword - --- - -*`user.changes.id`*:: -+ --- -Unique identifier of the user. - -type: keyword - -example: S-1-5-21-202424912787-2692429404-2351956786-1000 - --- - -*`user.changes.name`*:: -+ --- -Short name or login of the user. - -type: keyword - -example: a.einstein - --- - -*`user.changes.name.text`*:: -+ --- -type: match_only_text - --- - -*`user.changes.roles`*:: -+ --- -Array of user roles at the time of the event. - -type: keyword - -example: ["kibana_admin", "reporting_user"] - --- - -*`user.domain`*:: -+ --- -Name of the directory the user is a member of. -For example, an LDAP or Active Directory domain name. - -type: keyword - --- - -*`user.effective.domain`*:: -+ --- -Name of the directory the user is a member of. -For example, an LDAP or Active Directory domain name. - -type: keyword - --- - -*`user.effective.email`*:: -+ --- -User email address. - -type: keyword - --- - -*`user.effective.full_name`*:: -+ --- -User's full name, if available. - -type: keyword - -example: Albert Einstein - --- - -*`user.effective.full_name.text`*:: -+ --- -type: match_only_text - --- - -*`user.effective.group.domain`*:: -+ --- -Name of the directory the group is a member of. -For example, an LDAP or Active Directory domain name. - -type: keyword - --- - -*`user.effective.group.id`*:: -+ --- -Unique identifier for the group on the system/platform. - -type: keyword - --- - -*`user.effective.group.name`*:: -+ --- -Name of the group. - -type: keyword - --- - -*`user.effective.hash`*:: -+ --- -Unique user hash to correlate information for a user in anonymized form. -Useful if `user.id` or `user.name` contain confidential information and cannot be used. - -type: keyword - --- - -*`user.effective.id`*:: -+ --- -Unique identifier of the user. - -type: keyword - -example: S-1-5-21-202424912787-2692429404-2351956786-1000 - --- - -*`user.effective.name`*:: -+ --- -Short name or login of the user. - -type: keyword - -example: a.einstein - --- - -*`user.effective.name.text`*:: -+ --- -type: match_only_text - --- - -*`user.effective.roles`*:: -+ --- -Array of user roles at the time of the event. - -type: keyword - -example: ["kibana_admin", "reporting_user"] - --- - -*`user.email`*:: -+ --- -User email address. - -type: keyword - --- - -*`user.full_name`*:: -+ --- -User's full name, if available. - -type: keyword - -example: Albert Einstein - --- - -*`user.full_name.text`*:: -+ --- -type: match_only_text - --- - -*`user.group.domain`*:: -+ --- -Name of the directory the group is a member of. -For example, an LDAP or Active Directory domain name. - -type: keyword - --- - -*`user.group.id`*:: -+ --- -Unique identifier for the group on the system/platform. - -type: keyword - --- - -*`user.group.name`*:: -+ --- -Name of the group. - -type: keyword - --- - -*`user.hash`*:: -+ --- -Unique user hash to correlate information for a user in anonymized form. -Useful if `user.id` or `user.name` contain confidential information and cannot be used. - -type: keyword - --- - -*`user.id`*:: -+ --- -Unique identifier of the user. - -type: keyword - -example: S-1-5-21-202424912787-2692429404-2351956786-1000 - --- - -*`user.name`*:: -+ --- -Short name or login of the user. - -type: keyword - -example: a.einstein - --- - -*`user.name.text`*:: -+ --- -type: match_only_text - --- - -*`user.roles`*:: -+ --- -Array of user roles at the time of the event. - -type: keyword - -example: ["kibana_admin", "reporting_user"] - --- - -*`user.target.domain`*:: -+ --- -Name of the directory the user is a member of. -For example, an LDAP or Active Directory domain name. - -type: keyword - --- - -*`user.target.email`*:: -+ --- -User email address. - -type: keyword - --- - -*`user.target.full_name`*:: -+ --- -User's full name, if available. - -type: keyword - -example: Albert Einstein - --- - -*`user.target.full_name.text`*:: -+ --- -type: match_only_text - --- - -*`user.target.group.domain`*:: -+ --- -Name of the directory the group is a member of. -For example, an LDAP or Active Directory domain name. - -type: keyword - --- - -*`user.target.group.id`*:: -+ --- -Unique identifier for the group on the system/platform. - -type: keyword - --- - -*`user.target.group.name`*:: -+ --- -Name of the group. - -type: keyword - --- - -*`user.target.hash`*:: -+ --- -Unique user hash to correlate information for a user in anonymized form. -Useful if `user.id` or `user.name` contain confidential information and cannot be used. - -type: keyword - --- - -*`user.target.id`*:: -+ --- -Unique identifier of the user. - -type: keyword - -example: S-1-5-21-202424912787-2692429404-2351956786-1000 - --- - -*`user.target.name`*:: -+ --- -Short name or login of the user. - -type: keyword - -example: a.einstein - --- - -*`user.target.name.text`*:: -+ --- -type: match_only_text - --- - -*`user.target.roles`*:: -+ --- -Array of user roles at the time of the event. - -type: keyword - -example: ["kibana_admin", "reporting_user"] - --- - -[float] -=== user_agent - -The user_agent fields normally come from a browser request. -They often show up in web service logs coming from the parsed user agent string. - - -*`user_agent.device.name`*:: -+ --- -Name of the device. - -type: keyword - -example: iPhone - --- - -*`user_agent.name`*:: -+ --- -Name of the user agent. - -type: keyword - -example: Safari - --- - -*`user_agent.original`*:: -+ --- -Unparsed user_agent string. - -type: keyword - -example: Mozilla/5.0 (iPhone; CPU iPhone OS 12_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/12.0 Mobile/15E148 Safari/604.1 - --- - -*`user_agent.original.text`*:: -+ --- -type: match_only_text - --- - -*`user_agent.os.family`*:: -+ --- -OS family (such as redhat, debian, freebsd, windows). - -type: keyword - -example: debian - --- - -*`user_agent.os.full`*:: -+ --- -Operating system name, including the version or code name. - -type: keyword - -example: Mac OS Mojave - --- - -*`user_agent.os.full.text`*:: -+ --- -type: match_only_text - --- - -*`user_agent.os.kernel`*:: -+ --- -Operating system kernel version as a raw string. - -type: keyword - -example: 4.4.0-112-generic - --- - -*`user_agent.os.name`*:: -+ --- -Operating system name, without the version. - -type: keyword - -example: Mac OS X - --- - -*`user_agent.os.name.text`*:: -+ --- -type: match_only_text - --- - -*`user_agent.os.platform`*:: -+ --- -Operating system platform (such centos, ubuntu, windows). - -type: keyword - -example: darwin - --- - -*`user_agent.os.type`*:: -+ --- -Use the `os.type` field to categorize the operating system into one of the broad commercial families. -One of these following values should be used (lowercase): linux, macos, unix, windows. -If the OS you're dealing with is not in the list, the field should not be populated. Please let us know by opening an issue with ECS, to propose its addition. - -type: keyword - -example: macos - --- - -*`user_agent.os.version`*:: -+ --- -Operating system version as a raw string. - -type: keyword - -example: 10.14.1 - --- - -*`user_agent.version`*:: -+ --- -Version of the user agent. - -type: keyword - -example: 12.0 - --- - -[float] -=== vlan - -The VLAN fields are used to identify 802.1q tag(s) of a packet, as well as ingress and egress VLAN associations of an observer in relation to a specific packet or connection. -Network.vlan fields are used to record a single VLAN tag, or the outer tag in the case of q-in-q encapsulations, for a packet or connection as observed, typically provided by a network sensor (e.g. Zeek, Wireshark) passively reporting on traffic. -Network.inner VLAN fields are used to report inner q-in-q 802.1q tags (multiple 802.1q encapsulations) as observed, typically provided by a network sensor (e.g. Zeek, Wireshark) passively reporting on traffic. Network.inner VLAN fields should only be used in addition to network.vlan fields to indicate q-in-q tagging. -Observer.ingress and observer.egress VLAN values are used to record observer specific information when observer events contain discrete ingress and egress VLAN information, typically provided by firewalls, routers, or load balancers. - - -*`vlan.id`*:: -+ --- -VLAN ID as reported by the observer. - -type: keyword - -example: 10 - --- - -*`vlan.name`*:: -+ --- -Optional VLAN name as reported by the observer. - -type: keyword - -example: outside - --- - -[float] -=== vulnerability - -The vulnerability fields describe information about a vulnerability that is relevant to an event. - - -*`vulnerability.category`*:: -+ --- -The type of system or architecture that the vulnerability affects. These may be platform-specific (for example, Debian or SUSE) or general (for example, Database or Firewall). For example (https://qualysguard.qualys.com/qwebhelp/fo_portal/knowledgebase/vulnerability_categories.htm[Qualys vulnerability categories]) -This field must be an array. - -type: keyword - -example: ["Firewall"] - --- - -*`vulnerability.classification`*:: -+ --- -The classification of the vulnerability scoring system. For example (https://www.first.org/cvss/) - -type: keyword - -example: CVSS - --- - -*`vulnerability.description`*:: -+ --- -The description of the vulnerability that provides additional context of the vulnerability. For example (https://cve.mitre.org/about/faqs.html#cve_entry_descriptions_created[Common Vulnerabilities and Exposure CVE description]) - -type: keyword - -example: In macOS before 2.12.6, there is a vulnerability in the RPC... - --- - -*`vulnerability.description.text`*:: -+ --- -type: match_only_text - --- - -*`vulnerability.enumeration`*:: -+ --- -The type of identifier used for this vulnerability. For example (https://cve.mitre.org/about/) - -type: keyword - -example: CVE - --- - -*`vulnerability.id`*:: -+ --- -The identification (ID) is the number portion of a vulnerability entry. It includes a unique identification number for the vulnerability. For example (https://cve.mitre.org/about/faqs.html#what_is_cve_id)[Common Vulnerabilities and Exposure CVE ID] - -type: keyword - -example: CVE-2019-00001 - --- - -*`vulnerability.reference`*:: -+ --- -A resource that provides additional information, context, and mitigations for the identified vulnerability. - -type: keyword - -example: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-6111 - --- - -*`vulnerability.report_id`*:: -+ --- -The report or scan identification number. - -type: keyword - -example: 20191018.0001 - --- - -*`vulnerability.scanner.vendor`*:: -+ --- -The name of the vulnerability scanner vendor. - -type: keyword - -example: Tenable - --- - -*`vulnerability.score.base`*:: -+ --- -Scores can range from 0.0 to 10.0, with 10.0 being the most severe. -Base scores cover an assessment for exploitability metrics (attack vector, complexity, privileges, and user interaction), impact metrics (confidentiality, integrity, and availability), and scope. For example (https://www.first.org/cvss/specification-document) - -type: float - -example: 5.5 - --- - -*`vulnerability.score.environmental`*:: -+ --- -Scores can range from 0.0 to 10.0, with 10.0 being the most severe. -Environmental scores cover an assessment for any modified Base metrics, confidentiality, integrity, and availability requirements. For example (https://www.first.org/cvss/specification-document) - -type: float - -example: 5.5 - --- - -*`vulnerability.score.temporal`*:: -+ --- -Scores can range from 0.0 to 10.0, with 10.0 being the most severe. -Temporal scores cover an assessment for code maturity, remediation level, and confidence. For example (https://www.first.org/cvss/specification-document) - -type: float - --- - -*`vulnerability.score.version`*:: -+ --- -The National Vulnerability Database (NVD) provides qualitative severity rankings of "Low", "Medium", and "High" for CVSS v2.0 base score ranges in addition to the severity ratings for CVSS v3.0 as they are defined in the CVSS v3.0 specification. -CVSS is owned and managed by FIRST.Org, Inc. (FIRST), a US-based non-profit organization, whose mission is to help computer security incident response teams across the world. For example (https://nvd.nist.gov/vuln-metrics/cvss) - -type: keyword - -example: 2.0 - --- - -*`vulnerability.severity`*:: -+ --- -The severity of the vulnerability can help with metrics and internal prioritization regarding remediation. For example (https://nvd.nist.gov/vuln-metrics/cvss) - -type: keyword - -example: Critical - --- - -[float] -=== x509 - -This implements the common core fields for x509 certificates. This information is likely logged with TLS sessions, digital signatures found in executable binaries, S/MIME information in email bodies, or analysis of files on disk. -When the certificate relates to a file, use the fields at `file.x509`. When hashes of the DER-encoded certificate are available, the `hash` data set should be populated as well (e.g. `file.hash.sha256`). -Events that contain certificate information about network connections, should use the x509 fields under the relevant TLS fields: `tls.server.x509` and/or `tls.client.x509`. - - -*`x509.alternative_names`*:: -+ --- -List of subject alternative names (SAN). Name types vary by certificate authority and certificate type but commonly contain IP addresses, DNS names (and wildcards), and email addresses. - -type: keyword - -example: *.elastic.co - --- - -*`x509.issuer.common_name`*:: -+ --- -List of common name (CN) of issuing certificate authority. - -type: keyword - -example: Example SHA2 High Assurance Server CA - --- - -*`x509.issuer.country`*:: -+ --- -List of country (C) codes - -type: keyword - -example: US - --- - -*`x509.issuer.distinguished_name`*:: -+ --- -Distinguished name (DN) of issuing certificate authority. - -type: keyword - -example: C=US, O=Example Inc, OU=www.example.com, CN=Example SHA2 High Assurance Server CA - --- - -*`x509.issuer.locality`*:: -+ --- -List of locality names (L) - -type: keyword - -example: Mountain View - --- - -*`x509.issuer.organization`*:: -+ --- -List of organizations (O) of issuing certificate authority. - -type: keyword - -example: Example Inc - --- - -*`x509.issuer.organizational_unit`*:: -+ --- -List of organizational units (OU) of issuing certificate authority. - -type: keyword - -example: www.example.com - --- - -*`x509.issuer.state_or_province`*:: -+ --- -List of state or province names (ST, S, or P) - -type: keyword - -example: California - --- - -*`x509.not_after`*:: -+ --- -Time at which the certificate is no longer considered valid. - -type: date - -example: 2020-07-16 03:15:39+00:00 - --- - -*`x509.not_before`*:: -+ --- -Time at which the certificate is first considered valid. - -type: date - -example: 2019-08-16 01:40:25+00:00 - --- - -*`x509.public_key_algorithm`*:: -+ --- -Algorithm used to generate the public key. - -type: keyword - -example: RSA - --- - -*`x509.public_key_curve`*:: -+ --- -The curve used by the elliptic curve public key algorithm. This is algorithm specific. - -type: keyword - -example: nistp521 - --- - -*`x509.public_key_exponent`*:: -+ --- -Exponent used to derive the public key. This is algorithm specific. - -type: long - -example: 65537 - -Field is not indexed. - --- - -*`x509.public_key_size`*:: -+ --- -The size of the public key space in bits. - -type: long - -example: 2048 - --- - -*`x509.serial_number`*:: -+ --- -Unique serial number issued by the certificate authority. For consistency, if this value is alphanumeric, it should be formatted without colons and uppercase characters. - -type: keyword - -example: 55FBB9C7DEBF09809D12CCAA - --- - -*`x509.signature_algorithm`*:: -+ --- -Identifier for certificate signature algorithm. We recommend using names found in Go Lang Crypto library. See https://github.com/golang/go/blob/go1.14/src/crypto/x509/x509.go#L337-L353. - -type: keyword - -example: SHA256-RSA - --- - -*`x509.subject.common_name`*:: -+ --- -List of common names (CN) of subject. - -type: keyword - -example: shared.global.example.net - --- - -*`x509.subject.country`*:: -+ --- -List of country (C) code - -type: keyword - -example: US - --- - -*`x509.subject.distinguished_name`*:: -+ --- -Distinguished name (DN) of the certificate subject entity. - -type: keyword - -example: C=US, ST=California, L=San Francisco, O=Example, Inc., CN=shared.global.example.net - --- - -*`x509.subject.locality`*:: -+ --- -List of locality names (L) - -type: keyword - -example: San Francisco - --- - -*`x509.subject.organization`*:: -+ --- -List of organizations (O) of subject. - -type: keyword - -example: Example, Inc. - --- - -*`x509.subject.organizational_unit`*:: -+ --- -List of organizational units (OU) of subject. - -type: keyword - --- - -*`x509.subject.state_or_province`*:: -+ --- -List of state or province names (ST, S, or P) - -type: keyword - -example: California - --- - -*`x509.version_number`*:: -+ --- -Version of x509 format. - -type: keyword - -example: 3 - --- - -[[exported-fields-functionbeat]] -== Functionbeat fields - -None - -[[exported-fields-host-processor]] -== Host fields - -Info collected for the host machine. - - - - -*`host.containerized`*:: -+ --- -If the host is a container. - - -type: boolean - --- - -*`host.os.build`*:: -+ --- -OS build information. - - -type: keyword - -example: 18D109 - --- - -*`host.os.codename`*:: -+ --- -OS codename, if any. - - -type: keyword - -example: stretch - --- - -[[exported-fields-jolokia-autodiscover]] -== Jolokia Discovery autodiscover provider fields - -Metadata from Jolokia Discovery added by the jolokia provider. - - - -*`jolokia.agent.version`*:: -+ --- -Version number of jolokia agent. - - -type: keyword - --- - -*`jolokia.agent.id`*:: -+ --- -Each agent has a unique id which can be either provided during startup of the agent in form of a configuration parameter or being autodetected. If autodected, the id has several parts: The IP, the process id, hashcode of the agent and its type. - - -type: keyword - --- - -*`jolokia.server.product`*:: -+ --- -The container product if detected. - - -type: keyword - --- - -*`jolokia.server.version`*:: -+ --- -The container's version (if detected). - - -type: keyword - --- - -*`jolokia.server.vendor`*:: -+ --- -The vendor of the container the agent is running in. - - -type: keyword - --- - -*`jolokia.url`*:: -+ --- -The URL how this agent can be contacted. - - -type: keyword - --- - -*`jolokia.secured`*:: -+ --- -Whether the agent was configured for authentication or not. - - -type: boolean - --- - -[[exported-fields-kubernetes-processor]] -== Kubernetes fields - -Kubernetes metadata added by the kubernetes processor - - - - -*`kubernetes.pod.name`*:: -+ --- -Kubernetes pod name - - -type: keyword - --- - -*`kubernetes.pod.uid`*:: -+ --- -Kubernetes Pod UID - - -type: keyword - --- - -*`kubernetes.pod.ip`*:: -+ --- -Kubernetes Pod IP - - -type: ip - --- - -*`kubernetes.namespace`*:: -+ --- -Kubernetes namespace - - -type: keyword - --- - -*`kubernetes.node.name`*:: -+ --- -Kubernetes node name - - -type: keyword - --- - -*`kubernetes.node.hostname`*:: -+ --- -Kubernetes hostname as reported by the node’s kernel - - -type: keyword - --- - -*`kubernetes.labels.*`*:: -+ --- -Kubernetes labels map - - -type: object - --- - -*`kubernetes.annotations.*`*:: -+ --- -Kubernetes annotations map - - -type: object - --- - -*`kubernetes.selectors.*`*:: -+ --- -Kubernetes selectors map - - -type: object - --- - -*`kubernetes.replicaset.name`*:: -+ --- -Kubernetes replicaset name - - -type: keyword - --- - -*`kubernetes.deployment.name`*:: -+ --- -Kubernetes deployment name - - -type: keyword - --- - -*`kubernetes.statefulset.name`*:: -+ --- -Kubernetes statefulset name - - -type: keyword - --- - -*`kubernetes.container.name`*:: -+ --- -Kubernetes container name (different than the name from the runtime) - - -type: keyword - --- - -[[exported-fields-process]] -== Process fields - -Process metadata fields - - - - -*`process.exe`*:: -+ --- -type: alias - -alias to: process.executable - --- - -[float] -=== owner - -Process owner information. - - -*`process.owner.id`*:: -+ --- -Unique identifier of the user. - -type: keyword - --- - -*`process.owner.name`*:: -+ --- -Short name or login of the user. - -type: keyword - -example: albert - --- - -*`process.owner.name.text`*:: -+ --- -type: text - --- - -:edit_url!: \ No newline at end of file diff --git a/x-pack/functionbeat/docs/filtering.asciidoc b/x-pack/functionbeat/docs/filtering.asciidoc deleted file mode 100644 index c22366c0ee7..00000000000 --- a/x-pack/functionbeat/docs/filtering.asciidoc +++ /dev/null @@ -1,30 +0,0 @@ -[[filtering-and-enhancing-data]] -[role="xpack"] -== Filter and enhance data with processors - -++++ -Processors -++++ - -Your use case might require only a subset of the data exported by {beatname_uc}, -or you might need to enhance the exported data (for example, by adding -metadata). {beatname_uc} provides a couple of options for filtering and -enhancing exported data. - -You can specify a <<{beatname_lc}-filter_pattern,`filter_pattern`>> to match the -data you want to send. This approach may reduce execution costs because the -function running {beatname_uc} only executes if there is data that matches the -pattern. - -Another approach (the one described here) is to define processors. - - -[float] -[[using-processors]] -=== Processors - -include::{libbeat-dir}/processors.asciidoc[] - -:processor-scope: function -include::{libbeat-dir}/processors-using.asciidoc[] -:processor-scope!: diff --git a/x-pack/functionbeat/docs/general-options.asciidoc b/x-pack/functionbeat/docs/general-options.asciidoc deleted file mode 100644 index 5b21951bcfd..00000000000 --- a/x-pack/functionbeat/docs/general-options.asciidoc +++ /dev/null @@ -1,13 +0,0 @@ -[[configuration-general-options]] -[role="xpack"] -== Configure general settings - -++++ -General settings -++++ - -You can specify settings in the +{beatname_lc}.yml+ config file to control the -general behavior of {beatname_uc}. - -include::{libbeat-dir}/generalconfig.asciidoc[] - diff --git a/x-pack/functionbeat/docs/getting-started.asciidoc b/x-pack/functionbeat/docs/getting-started.asciidoc deleted file mode 100644 index adbf4ec6717..00000000000 --- a/x-pack/functionbeat/docs/getting-started.asciidoc +++ /dev/null @@ -1,167 +0,0 @@ -[id="{beatname_lc}-installation-configuration"] -[role="xpack"] -== {beatname_uc} quick start: installation and configuration - -++++ -Quick start: installation and configuration -++++ - -This guide describes how to get started quickly monitoring data from your cloud -services. You'll learn how to: - - -* download the {beatname_uc} distribution -* configure details about the cloud functions you want to deploy, including the -services to monitor and triggers -* deploy the cloud functions to your serverless environment -* collect data from cloud services and ship it to the {stack} -* visualize the data in {kib} - -[float] -[[install]] -=== Step 1: Download {beatname_uc} - -The {beatname_uc} distribution contains the command line tools, configuration -file, and binary code required to run {beatname_uc} in your serverless -environment. - -To download and extract the package, use the commands that work with your -system. - -include::{libbeat-dir}/tab-widgets/install-linux-mac-win-short-widget.asciidoc[] - -The commands shown are for AMD platforms, but ARM packages are also available. -Refer to the https://www.elastic.co/downloads/beats/{beatname_lc}[download page] -for the full list of available packages. - -[float] -[[set-connection]] -=== Step 2: Connect to the {stack} - -include::{libbeat-dir}/shared/connecting-to-es.asciidoc[] - -[float] -[[configuration]] -=== Step 3: Configure cloud functions - -Before deploying {beatname_uc} to your cloud provider, you need to specify -details about the cloud functions that you want to deploy, including the -function name and type, and the triggers that will cause the function to -execute. - -In +{beatname_lc}.yml+, configure the functions that you want to deploy. The -configuration settings vary depending on the type of function and cloud provider -you're using. This section provides a an AWS example configuration. - -This example configures a function called `cloudwatch` that collects events from -CloudWatch Logs. When a message is sent to the specified log group, the cloud -function executes and sends message events to the configured output: - -["source","sh",subs="attributes"] -------------------------------------------------------------------------------------- -{beatname_lc}.provider.aws.endpoint: "s3.amazonaws.com" -{beatname_lc}.provider.aws.deploy_bucket: "functionbeat-deploy" <1> -{beatname_lc}.provider.aws.functions: - - name: cloudwatch <2> - enabled: true - type: cloudwatch_logs - description: "lambda function for cloudwatch logs" - triggers: - - log_group_name: /aws/lambda/my-lambda-function -------------------------------------------------------------------------------------- -<1> A unique name for the S3 bucket to which the functions will be -uploaded. -<2> Details about the function you want to deploy, including the name of the -function, the type of service to monitor, and the log groups that trigger the -function. - -See <> for more examples. - -include::{libbeat-dir}/shared/config-check.asciidoc[] - -[float] -[[setup-assets]] -=== Step 4: Set up assets - -{beatname_uc} comes with predefined assets for parsing, indexing, and -visualizing your data. To load these assets: - -. Make sure the user specified in +{beatname_lc}.yml+ is -<>. - -. From the installation directory, run: -+ --- -include::{libbeat-dir}/tab-widgets/setup-linux-mac-win-widget.asciidoc[] --- -+ -`-e` is optional and sends output to standard error instead of the configured log output. - -This step loads the recommended {ref}/index-templates.html[index template] for writing to {es}. - -[TIP] -===== -A connection to {es} (or {ess}) is required to set up the initial -environment. If you're using a different output, such as {ls}, see -<>. -===== - -[float] -[id="{beatname_lc}-deploying"] -[role="xpack"] -=== Step 5: Deploy {beatname_uc} - -To deploy {beatname_uc} functions to your cloud provider, either use the -{beatname_uc} manager, as described here, or <>. - -TIP: If you change the configuration after deploying the function, use -the <> to update your deployment. - -[float] -[[deploy-to-aws]] -==== Deploy to AWS - -. Make sure you have the credentials required to authenticate with AWS. You can -set environment variables that contain your credentials: -+ --- -include::tab-widgets/credentials-aws-widget.asciidoc[] --- -+ -Set `AWS_DEFAULT_REGION` to the region where your services are running. - -. Make sure the user has the permissions required to deploy and run the -function. For more information, see <>. - -. Deploy the cloud functions. -+ -For example, the following command deploys a function called `cloudwatch`: -+ --- -include::tab-widgets/deploy-aws-widget.asciidoc[] --- -+ -The function is deployed to AWS and ready to send log events to the configured -output. -+ -If deployment fails, see <> for help troubleshooting. - -:fnexample!: - -[float] -[[view-data]] -=== Step 6: View your data in {kib} - -There are currently no example dashboards available for {beatname_uc}. - -To learn how to view and explore your data, see the -_{kibana-ref}/index.html[{kib} User Guide]_. - -[float] -=== What's next? - -Now that you have your cloud data streaming into {es}, learn how to unify your -logs, metrics, uptime, and application performance data. - -include::{libbeat-dir}/shared/obs-apps.asciidoc[] diff --git a/x-pack/functionbeat/docs/howto/howto.asciidoc b/x-pack/functionbeat/docs/howto/howto.asciidoc deleted file mode 100644 index f116bc57d0c..00000000000 --- a/x-pack/functionbeat/docs/howto/howto.asciidoc +++ /dev/null @@ -1,42 +0,0 @@ -[[howto-guides]] -[role="xpack"] -= How to guides - -[partintro] --- -Learn how to perform common {beatname_uc} configuration tasks. - -* <<{beatname_lc}-template>> -* <> -* <<{beatname_lc}-geoip>> -* <> -* <> -* <> - - --- - -[role="xpack"] -include::{libbeat-dir}/howto/load-index-templates.asciidoc[] - -[role="xpack"] -include::{libbeat-dir}/howto/change-index-name.asciidoc[] - -[role="xpack"] -include::{libbeat-dir}/shared-geoip.asciidoc[] - -:standalone: -[role="xpack"] -include::{libbeat-dir}/shared-env-vars.asciidoc[] -:standalone!: - -[role="xpack"] -include::{libbeat-dir}/shared-config-ingest.asciidoc[] - -:standalone: -[role="xpack"] -include::{libbeat-dir}/yaml.asciidoc[] -:standalone!: - - - diff --git a/x-pack/functionbeat/docs/iam-permissions.asciidoc b/x-pack/functionbeat/docs/iam-permissions.asciidoc deleted file mode 100644 index 606f3c79239..00000000000 --- a/x-pack/functionbeat/docs/iam-permissions.asciidoc +++ /dev/null @@ -1,134 +0,0 @@ -[[iam-permissions]] -[role="xpack"] -=== IAM permissions required to deploy {beatname_uc} - -++++ -IAM permissions required for deployment -++++ - -This section describes the minimum privileges or roles required to deploy -functions to your cloud provider. - -[[iam-permissions-aws]] -==== Permissions required by AWS - -The list of required permissions depends on the type of events that you are -collecting. Here are some example policies that grant the required privileges. - -[[iam-permissions-cloudwatch]] -===== CloudWatch logs - -The following policy grants the permissions required to deploy and run a Lambda -function that collects events from CloudWatch logs. - -[source,yaml] ----- -{ - "Version": "2012-10-17", - "Statement": [ - { - "Sid": "VisualEditor0", - "Effect": "Allow", - "Action": [ - "cloudformation:CreateStack", - "cloudformation:DeleteStack", - "cloudformation:DescribeStacks", - "cloudformation:DescribeStackEvents", - "cloudformation:DescribeStackResources", - "cloudformation:GetTemplate", - "cloudformation:UpdateStack", - "cloudformation:ValidateTemplate", - "iam:CreateRole", - "iam:DeleteRole", - "iam:DeleteRolePolicy", - "iam:GetRole", - "iam:GetRolePolicy", - "iam:PassRole", - "iam:PutRolePolicy", - "lambda:AddPermission", - "lambda:CreateFunction", - "lambda:DeleteFunction", - "lambda:GetFunction", - "lambda:GetFunctionConfiguration", - "lambda:PutFunctionConcurrency", - "lambda:RemovePermission", - "lambda:UpdateFunctionCode", - "lambda:UpdateFunctionConfiguration", - "logs:CreateLogGroup", - "logs:DeleteLogGroup", - "logs:DeleteSubscriptionFilter", - "logs:DescribeLogGroups", - "logs:PutSubscriptionFilter", - "s3:CreateBucket", - "s3:DeleteObject", - "s3:ListBucket", - "s3:PutObject", - "s3:GetObject", - "ec2:DescribeSecurityGroups", - "ec2:DescribeSubnets", - "ec2:DescribeVpcs" - ], - "Resource": "*" - } - ] -} ----- - -[[iam-permissions-sqs-kinesis]] -===== SQS and Kinesis - -The following policy grants the permissions required to deploy and run a Lambda -function that reads from SQS queues or Kinesis data streams. - -[source,yaml] ----- -{ - "Version": "2012-10-17", - "Statement": [ - { - "Sid": "VisualEditor0", - "Effect": "Allow", - "Action": [ - "cloudformation:CreateStack", - "cloudformation:DeleteStack", - "cloudformation:DescribeStacks", - "cloudformation:DescribeStackEvents", - "cloudformation:DescribeStackResources", - "cloudformation:GetTemplate", - "cloudformation:UpdateStack", - "cloudformation:ValidateTemplate", - "iam:CreateRole", - "iam:DeleteRole", - "iam:DeleteRolePolicy", - "iam:GetRole", - "iam:GetRolePolicy", - "iam:PassRole", - "iam:PutRolePolicy", - "lambda:AddPermission", - "lambda:CreateFunction", - "lambda:CreateEventSourceMapping", - "lambda:DeleteFunction", - "lambda:DeleteEventSourceMapping", - "lambda:GetEventSourceMapping", - "lambda:GetFunction", - "lambda:GetFunctionConfiguration", - "lambda:PutFunctionConcurrency", - "lambda:RemovePermission", - "lambda:UpdateFunctionCode", - "lambda:UpdateFunctionConfiguration", - "logs:DescribeLogGroups", - "logs:CreateLogGroup", - "s3:CreateBucket", - "s3:DeleteObject", - "s3:ListBucket", - "s3:PutObject", - "s3:GetObject", - "ec2:DescribeSecurityGroups", - "ec2:DescribeSubnets", - "ec2:DescribeVpcs" - ], - "Resource": "*" - } - ] -} ----- diff --git a/x-pack/functionbeat/docs/images/coordinate-map.png b/x-pack/functionbeat/docs/images/coordinate-map.png deleted file mode 100644 index 8ac69fe747cfda15ef0eddcf617e18914409b970..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 370029 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

VC(~Wk}*sj{oYoO>%PA;~k!E#ln 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�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�Y)=cFN$-E4 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͜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 mfguYFSzyQlLly{F;Qs+MHH%8#Dv;>_0000 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/x-pack/functionbeat/docs/images/functionbeat-pipeline-cloudwatchlogs.png b/x-pack/functionbeat/docs/images/functionbeat-pipeline-cloudwatchlogs.png deleted file mode 100644 index d020044eb98a5743d07e64d36583eb5126664282..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 82236 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%0D!qF7omEAFz?XHw`T7)uT&< z^Fg3wxe<|=NaDoJP2=4BFoA>=}X5INY^JCUMYcCeIclYkD zu6pXJ>T0rIE~$>J>XrG^Cv(9hi!9_rI`b!P!Z6t;zQA&>tPcL#w=`x3nffKU(mZ!r z%B0eplA6U5HM65>(j`wQ(Sf_PVBm40QmW--47zzy%x!>o?Q(KZaPStNWYqMz`f^<7 zbW7B4x0D_`mj1ro>C=)6Eo=5+rth+M7opN#%`S@dD76Snct+_4MwRsi1qEi&!E8Wb zX9B$p>cI%Tf{n!%R8)*Ke3AoL8ZZD_sxd$}gHizpBTUvUcTR?eIbq-O%Cp-nwK;wf z6oJ{OtE;Q1P+%&k0QbXSy!FiTcjKr>MJpfzyA zf{hv|m+0bB|AXiTKbPQQ`)$%dAt=^>sXIPC4(@2~{##L532o86{byUIM+6_!M*X57 zPR*mtyz@-l@fvnJI8at<-E>Pu5mT%{8Xbe=1)-AOE190fr{aaScp@zBP1VnShM5%0 zNKOKszu0i#bz0vqHJV7IYG~*;V*^LVKaim1aARp`zk&UHc{66RbbW4R9A}?4w?5_{ zl)*c^>x~SY6uebu5A&ml7tmfoGzpxshxCiYqO!)ji8n2>IWNYVvYI7L`1|;g5>#`J z_jTZ4wp7Svz;`H2 zcSD)LmIkox{zXX}C{`32H0=+Eyb~Q(2;>Mnc>g;3eL@?olV9wyig$}Y!AHyP*QqXT zK`c$%df#hm^qES!=TH@qg9ROlXUFs6b-rBmJ^HLP6>q)bYMMXqEF+&?+bi~VsF@QVOUUSaj8r%+4^ORqRY?m14a06KQTy2 zS>93NJ1JG9+tEqm#}2cbH4@)WSvk`S3<}C&IoR4NAQ}fgCsS{EO-& $t5Mw`2rfna&LSBz5Gc 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 diff --git a/x-pack/functionbeat/docs/images/functionbeat-pipeline-sqs.png b/x-pack/functionbeat/docs/images/functionbeat-pipeline-sqs.png deleted file mode 100644 index 85ce2764369ee3a66cda6651aaae8044d12c2e32..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 81731 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�c{@&GlDmD$9xdM6)uw$q}4mHgJ1 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%0DcSo6(2ubkPV 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 diff --git a/x-pack/functionbeat/docs/index.asciidoc b/x-pack/functionbeat/docs/index.asciidoc deleted file mode 100644 index 3ab8578a0bc..00000000000 --- a/x-pack/functionbeat/docs/index.asciidoc +++ /dev/null @@ -1,64 +0,0 @@ -= Functionbeat Reference - -:libbeat-dir: {docdir}/../../../libbeat/docs - -include::{libbeat-dir}/version.asciidoc[] - -include::{asciidoc-dir}/../../shared/versions/stack/{source_branch}.asciidoc[] - -include::{asciidoc-dir}/../../shared/attributes.asciidoc[] - -:beatname_lc: functionbeat -:beatname_uc: Functionbeat -:beatname_pkg: {beatname_lc} -:github_repo_name: beats -:discuss_forum: beats/{beatname_lc} -:beat_default_index_prefix: {beatname_lc} -:has_ml_jobs: no -:libbeat-docs: Beats Platform Reference -:cloudformation-ref: https://aws.amazon.com/cloudformation/[AWS CloudFormation] -:no_kafka_output: -:no_redis_output: -:no_file_output: -:requires_xpack: -:serverless: -:mac_os: -:win_os: -:linux_os: -:no_cache_processor: -:no_dashboards: -:no_repos: -:no_decode_cef_processor: -:no_decode_csv_fields_processor: -:no_parse_aws_vpc_flow_log_processor: -:no_script_processor: -:no_timestamp_processor: -:no_keystore: -:no_add_session_metadata_processor: - -include::{libbeat-dir}/shared-beats-attributes.asciidoc[] - -include::./overview.asciidoc[] - -include::./getting-started.asciidoc[] - -include::./setting-up-running.asciidoc[] - -include::./configuring-howto.asciidoc[] - -include::{docdir}/howto/howto.asciidoc[] - -[role="xpack"] -include::./fields.asciidoc[] - -[role="xpack"] -include::{libbeat-dir}/monitoring/monitoring-beats.asciidoc[] - -[role="xpack"] -include::{libbeat-dir}/shared-securing-beat.asciidoc[] - -include::./troubleshooting.asciidoc[] - -include::./faq.asciidoc[] - - diff --git a/x-pack/functionbeat/docs/overview.asciidoc b/x-pack/functionbeat/docs/overview.asciidoc deleted file mode 100644 index 456b9795ce7..00000000000 --- a/x-pack/functionbeat/docs/overview.asciidoc +++ /dev/null @@ -1,99 +0,0 @@ -[id="{beatname_lc}-overview"] -[role="xpack"] -== {beatname_uc} overview - -IMPORTANT: Beginning with version 8.10.4 the {beatname_uc} documentation is no longer being updated. -We recommend instead to use {esf-ref}[{esf}] to ships logs from your AWS environment to Elastic. - -{beatname_uc} is an Elastic https://www.elastic.co/beats[Beat] that you -deploy as a function in your serverless environment to collect data from cloud -services and ship it to the {stack}. - -Version {version} supports deploying {beatname_uc} as an AWS Lambda service. It -responds to triggers defined for the following event sources: - -* https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/WhatIsCloudWatchLogs.html[Amazon CloudWatch Logs] -* https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/welcome.html[Amazon Simple Queue Service (SQS)] -* https://docs.aws.amazon.com/kinesis/latest/APIReference/Welcome.html[Amazon Kinesis] - -image::./images/diagram-functionbeat-architecture.svg["{beatname_uc} collects events generated by cloud services"] - -include::{libbeat-dir}/shared-libbeat-description.asciidoc[] - -The following sections explore some common use cases for {beatname_uc}: - -* <> -* <> - -*Want to ship logs from Google Cloud?* Use our Google Cloud Dataflow templates -to ship Google Pub/Sub and Google Cloud Storage logs directly from the Google -Cloud Console. To learn more, refer to -{observability-guide}/gcp-dataflow.html[GCP Dataflow templates]. - -[float] -[[monitor-cloud-deployments]] -=== Monitor cloud deployments - -You can deploy {beatname_uc} on your serverless environment to collect logs and -metrics generated by cloud services and stream the data to the {stack} for -centralized analytics. - -[float] -==== Monitor AWS services with CloudWatch logs - -You can deploy {beatname_uc} as a Lambda function on AWS to receive events from -a Cloudwatch Log group, extract and structure the relevant fields, then stream -the events to {es}. - -The processing pipeline for this use case typically looks like this: - -. {beatname_uc} runs as a Lambda function on AWS and reads the data stream from -a Cloudwatch Log group. - -. {beats} processors, such as <> and <>, -filter and structure the events. - -. Optional {ref}/ingest.html[ingest pipelines] in {es} further enhance the -data. - -. The structured events are indexed into an {es} cluster. - -image::./images/functionbeat-pipeline-cloudwatchlogs.png["{beatname_uc} collects events generated by CloudWatch logs"] - -///// -The following is commented out until this architecture is fully enabled: -If you have multiple instances of CloudWatch logs and want to centralize your -logging environment in Amazon Kinesis, you can send the logs to Kinesis, then -use {beatname_uc} to receive events from Kinesis, process them, and then stream -them to {es} for further analysis. -///// - -[float] -[[event-drive-processing]] -=== Perform event-driven processing - -You can use {beatname_uc} to implement event-driven processing workflows with -cloud messaging queues and the {stack}. {beatname_uc} responds to event triggers -from AWS Kinesis and SQS. - -[float] -==== Analyze application data from SQS - -For applications that send JSON-encoded events to an SQS queue, {beatname_uc} -can listen for, ingest, and decode JSON events prior to -shipping them to {es}, where you can analyze the streaming data. - -The processing pipeline for this use case typically looks like this: - -. {beatname_uc} runs as a serverless shipper and listens to an SQS queue for -application events. - -. The {beats} <> processor -decodes JSON strings and replaces them with valid JSON objects. - -. Optional {ref}/ingest.html[ingest pipelines] in {es} further enhance the -data. - -. The events are indexed into an {es} cluster. - -image::./images/functionbeat-pipeline-sqs.png["{beatname_uc} application events triggered by SQS"] diff --git a/x-pack/functionbeat/docs/page_header.html b/x-pack/functionbeat/docs/page_header.html deleted file mode 100644 index 5c1aaf1ba11..00000000000 --- a/x-pack/functionbeat/docs/page_header.html +++ /dev/null @@ -1,3 +0,0 @@ -Functionbeat reached End of Support on October 18, 2023. You must consider -moving your deployments to the more versatile and efficient Elastic Serverless -Forwarder. diff --git a/x-pack/functionbeat/docs/setting-up-running.asciidoc b/x-pack/functionbeat/docs/setting-up-running.asciidoc deleted file mode 100644 index 823bbbd4067..00000000000 --- a/x-pack/functionbeat/docs/setting-up-running.asciidoc +++ /dev/null @@ -1,45 +0,0 @@ -///// -// NOTE: -// Each beat has its own setup overview to allow for the addition of content -// that is unique to each beat. -///// - -[[setting-up-and-running]] -[role="xpack"] -== Set up and deploy {beatname_uc} - -++++ -Set up and deploy -++++ - -Before reading this section, see -<<{beatname_lc}-installation-configuration>> for basic -installation instructions to get you started. - -This section includes additional information on how to install, set up, and run -{beatname_uc}, including: - -* <> - -* <> - -* <> - -* <> - -* <> - - -//MAINTAINERS: If you add a new file to this section, make sure you update the bulleted list ^^ too. - -[role="xpack"] -include::{libbeat-dir}/shared-directory-layout.asciidoc[] - -include::iam-permissions.asciidoc[] - -include::deploying.asciidoc[] - -[role="xpack"] -include::{libbeat-dir}/command-reference.asciidoc[] - -include::export-cloudformation-template.asciidoc[] diff --git a/x-pack/functionbeat/docs/tab-widgets/credentials-aws-widget.asciidoc b/x-pack/functionbeat/docs/tab-widgets/credentials-aws-widget.asciidoc deleted file mode 100644 index d1db7f99189..00000000000 --- a/x-pack/functionbeat/docs/tab-widgets/credentials-aws-widget.asciidoc +++ /dev/null @@ -1,58 +0,0 @@ -++++ -

-
- - - -
-
-++++ - -include::credentials-aws.asciidoc[tag=mac] - -++++ -
- - -
-++++ diff --git a/x-pack/functionbeat/docs/tab-widgets/credentials-aws.asciidoc b/x-pack/functionbeat/docs/tab-widgets/credentials-aws.asciidoc deleted file mode 100644 index 16f330c906f..00000000000 --- a/x-pack/functionbeat/docs/tab-widgets/credentials-aws.asciidoc +++ /dev/null @@ -1,26 +0,0 @@ -// tag::mac[] -[source, shell] ----- -export AWS_ACCESS_KEY_ID=ABCDEFGHIJKLMNOPUSER -export AWS_SECRET_ACCESS_KEY=EXAMPLE567890devgHIJKMLOPNQRSTUVZ1234KEY -export AWS_DEFAULT_REGION=us-east-1 ----- -// end::mac[] - -// tag::linux[] -[source, shell] ----- -export AWS_ACCESS_KEY_ID=ABCDEFGHIJKLMNOPUSER -export AWS_SECRET_ACCESS_KEY=EXAMPLE567890devgHIJKMLOPNQRSTUVZ1234KEY -export AWS_DEFAULT_REGION=us-east-1 ----- -// end::linux[] - -// tag::win[] -[source, shell] ----- -set AWS_ACCESS_KEY_ID=ABCDEFGHIJKLMNOPUSER -set AWS_SECRET_ACCESS_KEY=EXAMPLE567890devgHIJKMLOPNQRSTUVZ1234KEY -set AWS_DEFAULT_REGION=us-east-1 ----- -// end::win[] diff --git a/x-pack/functionbeat/docs/tab-widgets/deploy-aws-widget.asciidoc b/x-pack/functionbeat/docs/tab-widgets/deploy-aws-widget.asciidoc deleted file mode 100644 index a6575c0e859..00000000000 --- a/x-pack/functionbeat/docs/tab-widgets/deploy-aws-widget.asciidoc +++ /dev/null @@ -1,58 +0,0 @@ -++++ -
-
- - - -
-
-++++ - -include::deploy-aws.asciidoc[tag=mac] - -++++ -
- - -
-++++ diff --git a/x-pack/functionbeat/docs/tab-widgets/deploy-aws.asciidoc b/x-pack/functionbeat/docs/tab-widgets/deploy-aws.asciidoc deleted file mode 100644 index 9118384d6e0..00000000000 --- a/x-pack/functionbeat/docs/tab-widgets/deploy-aws.asciidoc +++ /dev/null @@ -1,19 +0,0 @@ -// tag::mac[] -["source","sh",subs="attributes"] ----- -./{beatname_lc} -v -e -d "*" deploy cloudwatch ----- -// end::mac[] - -// tag::linux[] -["source","sh",subs="attributes"] ----- -./{beatname_lc} -v -e -d "*" deploy cloudwatch ----- -// end::linux[] -// tag::win[] -["source","sh",subs="attributes"] ----- -.{backslash}{beatname_lc}.exe -v -e -d "*" deploy cloudwatch ----- -// end::win[] diff --git a/x-pack/functionbeat/docs/troubleshooting.asciidoc b/x-pack/functionbeat/docs/troubleshooting.asciidoc deleted file mode 100644 index 777f24edd82..00000000000 --- a/x-pack/functionbeat/docs/troubleshooting.asciidoc +++ /dev/null @@ -1,43 +0,0 @@ -[[troubleshooting]] -[role="xpack"] -= Troubleshoot - -[partintro] --- -If you have issues installing or running {beatname_uc}, read the -following tips: - -* <> -* <> -* <> -* <> - -//sets block macro for getting-help.asciidoc included in next section - --- - -[[getting-help]] -[role="xpack"] -== Get help - -include::{libbeat-dir}/getting-help.asciidoc[] - -//sets block macro for debugging.asciidoc included in next section - -[id="enable-{beatname_lc}-debugging"] -[role="xpack"] -== Debug - -include::{libbeat-dir}/debugging.asciidoc[] - -//sets block macro for metrics-in-logs.asciidoc included in next section - -[id="understand-{beatname_lc}-logs"] -[role="xpack"] -== Understand metrics in {beatname_uc} logs - -++++ -Understand logged metrics -++++ - -include::{libbeat-dir}/metrics-in-logs.asciidoc[] diff --git a/x-pack/functionbeat/function/beater/functionbeat.go b/x-pack/functionbeat/function/beater/functionbeat.go deleted file mode 100644 index 77ea2a7bd00..00000000000 --- a/x-pack/functionbeat/function/beater/functionbeat.go +++ /dev/null @@ -1,185 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package beater - -import ( - "context" - "fmt" - "os" - "strings" - "time" - - "github.com/elastic/beats/v7/libbeat/common/fmtstr" - "github.com/elastic/beats/v7/libbeat/outputs/elasticsearch" - "github.com/elastic/beats/v7/libbeat/publisher/pipeline" - "github.com/elastic/elastic-agent-libs/mapstr" - - "github.com/elastic/beats/v7/libbeat/beat" - "github.com/elastic/beats/v7/libbeat/licenser" - "github.com/elastic/beats/v7/libbeat/processors" - "github.com/elastic/beats/v7/x-pack/functionbeat/config" - "github.com/elastic/beats/v7/x-pack/functionbeat/function/core" - "github.com/elastic/beats/v7/x-pack/functionbeat/function/provider" - "github.com/elastic/beats/v7/x-pack/functionbeat/function/telemetry" - conf "github.com/elastic/elastic-agent-libs/config" - "github.com/elastic/elastic-agent-libs/logp" - "github.com/elastic/elastic-agent-libs/monitoring" -) - -var ( - graceDelay = 45 * time.Minute - refreshDelay = 15 * time.Minute - supportedOutputs = []string{ - "elasticsearch", - "logstash", - "console", // for local debugging - } -) - -// Functionbeat is a beat designed to run under a serverless environment and listen to external triggers, -// each invocation will generate one or more events to Elasticsearch. -// -// Each serverless implementation is different but functionbeat follows a few execution rules. -// - Publishing events from the source to the output is done synchronously. -// - Execution can be suspended. -// - Run on a read only filesystem -// - More execution constraints based on speed and memory usage. -type Functionbeat struct { - Ctx context.Context - log *logp.Logger - cancel context.CancelFunc - telemetry telemetry.T - Provider provider.Provider - Config *config.Config -} - -// New creates an instance of functionbeat. -func New(b *beat.Beat, cfg *conf.C) (beat.Beater, error) { - - c := &config.DefaultConfig - if err := cfg.Unpack(c); err != nil { - return nil, fmt.Errorf("error reading config file: %+v", err) - } - - provider, err := provider.Create(c.Provider) - if err != nil { - return nil, err - } - ctx, cancel := context.WithCancel(context.Background()) - - telemetryReg := monitoring.GetNamespace("state").GetRegistry().NewRegistry("functionbeat") - - bt := &Functionbeat{ - Ctx: ctx, - log: logp.NewLogger("functionbeat"), - cancel: cancel, - telemetry: telemetry.New(telemetryReg), - Provider: provider, - Config: c, - } - return bt, nil -} - -// Run starts functionbeat. -func (bt *Functionbeat) Run(b *beat.Beat) error { - defer bt.cancel() - - outputName := b.Config.Output.Name() - if !isOutputSupported(outputName) { - return fmt.Errorf("unsupported output type: %s; supported ones: %+v", outputName, supportedOutputs) - } - - elasticsearch.RegisterGlobalCallback(licenser.FetchAndVerify) - - bt.log.Info("Functionbeat is running") - defer bt.log.Info("Functionbeat stopped running") - - clientFactory := makeClientFactory(bt.log, b.Publisher, b.Info) - - enabledFunctions := bt.enabledFunctions() - bt.log.Infof("Functionbeat is configuring enabled functions: %s", strings.Join(enabledFunctions, ", ")) - // Create a client per function and wrap them into a runnable function by the coordinator. - functions, err := bt.Provider.CreateFunctions(clientFactory, enabledFunctions) - if err != nil { - return fmt.Errorf("error when creating the functions, error: %+v", err) - } - - // manages the goroutine related to the function handlers, if an error occurs and its not handled - // by the function itself, it will reach the coordinator, we log the error and shutdown beats. - // When an error reach the coordinator we assume that we cannot recover from it and we initiate - // a shutdown and return an aggregated errors. - coordinator := core.NewCoordinator(logp.NewLogger("coordinator"), functions...) - err = coordinator.Run(bt.Ctx, bt.telemetry) - if err != nil { - return err - } - return nil -} - -// enabledFunctions returns the enabled function types -func (bt *Functionbeat) enabledFunctions() (values []string) { - raw, found := os.LookupEnv("ENABLED_FUNCTIONS") - if !found { - return values - } - return strings.Split(raw, ",") -} - -// Stop stops functionbeat. -func (bt *Functionbeat) Stop() { - bt.log.Info("Functionbeat is stopping") - defer bt.log.Info("Functionbeat is stopped") - bt.cancel() -} - -func isOutputSupported(name string) bool { - for _, output := range supportedOutputs { - if name == output { - return true - } - } - return false -} - -type fnExtraConfig struct { - Processors processors.PluginConfig `config:"processors"` - - // KeepNull determines whether published events will keep null values or omit them. - KeepNull bool `config:"keep_null"` - - mapstr.EventMetadata `config:",inline"` // Fields and tags to add to events. - - // ES output index pattern - Index fmtstr.EventFormatString `config:"index"` -} - -func makeClientFactory(log *logp.Logger, pipe beat.Pipeline, beatInfo beat.Info) func(*conf.C) (pipeline.ISyncClient, error) { - // Each function has his own client to the publisher pipeline, - // publish operation will block the calling thread, when the method unwrap we have received the - // ACK for the batch. - return func(cfg *conf.C) (pipeline.ISyncClient, error) { - c := fnExtraConfig{} - - if err := cfg.Unpack(&c); err != nil { - return nil, err - } - - funcProcessors, err := processorsForFunction(beatInfo, c) - if err != nil { - return nil, err - } - - client, err := pipeline.NewSyncClient(log, pipe, beat.ClientConfig{ - PublishMode: beat.GuaranteedSend, - Processing: beat.ProcessingConfig{ - Processor: funcProcessors, - EventMetadata: c.EventMetadata, - KeepNull: c.KeepNull, - }, - }) - - return client, err - } -} diff --git a/x-pack/functionbeat/function/beater/proccessors_test.go b/x-pack/functionbeat/function/beater/proccessors_test.go deleted file mode 100644 index d15f5320e40..00000000000 --- a/x-pack/functionbeat/function/beater/proccessors_test.go +++ /dev/null @@ -1,124 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package beater - -import ( - "testing" - "time" - - "github.com/stretchr/testify/assert" - - "github.com/elastic/beats/v7/libbeat/beat" - _ "github.com/elastic/beats/v7/libbeat/processors/actions" - conf "github.com/elastic/elastic-agent-libs/config" - "github.com/elastic/elastic-agent-libs/mapstr" -) - -func TestProcessorsForFunction(t *testing.T) { - testCases := map[string]struct { - beatInfo beat.Info - configStr string - event beat.Event - expectedFields map[string]string - }{ - "Simple static index": { - configStr: "index: 'test'", - expectedFields: map[string]string{ - "@metadata.raw_index": "test", - }, - }, - "Index with agent info + timestamp": { - beatInfo: beat.Info{Beat: "TestBeat", Version: "3.9.27"}, - configStr: "index: 'beat-%{[agent.name]}-%{[agent.version]}-%{+yyyy.MM.dd}'", - event: beat.Event{Timestamp: time.Date(1999, time.December, 31, 23, 0, 0, 0, time.UTC)}, - expectedFields: map[string]string{ - "@metadata.raw_index": "beat-TestBeat-3.9.27-1999.12.31", - }, - }, - "Set field in input config": { - configStr: `processors: [add_fields: {fields: {testField: inputConfig}}]`, - expectedFields: map[string]string{ - "fields.testField": "inputConfig", - }, - }, - } - for description, test := range testCases { - if test.event.Fields == nil { - test.event.Fields = mapstr.M{} - } - config, err := functionConfigFromString(test.configStr) - if err != nil { - t.Errorf("[%s] %v", description, err) - continue - } - processors, err := processorsForFunction(test.beatInfo, config) - if err != nil { - t.Errorf("[%s] %v", description, err) - continue - } - processedEvent, err := processors.Run(&test.event) - // We don't check if err != nil, because we are testing the final outcome - // of running the processors, including when some of them fail. - if processedEvent == nil { - t.Errorf("[%s] Unexpected fatal error running processors: %v\n", - description, err) - } - for key, value := range test.expectedFields { - field, err := processedEvent.GetValue(key) - if err != nil { - t.Errorf("[%s] Couldn't get field %s from event: %v", description, key, err) - continue - } - assert.Equal(t, field, value) - fieldStr, ok := field.(string) - if !ok { - // Note that requiring a string here is just to simplify the test setup, - // not a requirement of the underlying api. - t.Errorf("[%s] Field [%s] should be a string", description, key) - continue - } - if fieldStr != value { - t.Errorf("[%s] Event field [%s]: expected [%s], got [%s]", description, key, value, fieldStr) - } - } - } -} - -func TestProcessorsForFunctionIsFlat(t *testing.T) { - // This test is regrettable, and exists because of inconsistencies in - // processor handling between processors.Processors and processing.group - // (which implements beat.ProcessorList) -- see processorsForConfig for - // details. The upshot is that, for now, if the function configuration specifies - // processors, they must be returned as direct children of the resulting - // processors.Processors (rather than being collected in additional tree - // structure). - // This test should be removed once we have a more consistent mechanism for - // collecting and running processors. - configStr := `processors: -- add_fields: {fields: {testField: value}} -- add_fields: {fields: {testField2: stuff}}` - config, err := functionConfigFromString(configStr) - if err != nil { - t.Fatal(err) - } - processors, err := processorsForFunction( - beat.Info{}, config) - if err != nil { - t.Fatal(err) - } - assert.Equal(t, 2, len(processors.List)) -} - -// Helper function to convert from YML input string to an unpacked -// fnExtraConfig -func functionConfigFromString(s string) (fnExtraConfig, error) { - config := fnExtraConfig{} - cfg, err := conf.NewConfigFrom(s) - if err != nil { - return config, err - } - err = cfg.Unpack(&config) - return config, err -} diff --git a/x-pack/functionbeat/function/beater/processors.go b/x-pack/functionbeat/function/beater/processors.go deleted file mode 100644 index 23c5da9ca23..00000000000 --- a/x-pack/functionbeat/function/beater/processors.go +++ /dev/null @@ -1,38 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package beater - -import ( - "github.com/elastic/beats/v7/libbeat/beat" - "github.com/elastic/beats/v7/libbeat/common/fmtstr" - "github.com/elastic/beats/v7/libbeat/processors" - "github.com/elastic/beats/v7/libbeat/processors/add_formatted_index" -) - -func processorsForFunction(beatInfo beat.Info, config fnExtraConfig) (*processors.Processors, error) { - procs := processors.NewList(nil) - - // Processor ordering is important: - // 1. Index configuration - if !config.Index.IsEmpty() { - staticFields := fmtstr.FieldsForBeat(beatInfo.Beat, beatInfo.Version) - timestampFormat, err := - fmtstr.NewTimestampFormatString(&config.Index, staticFields) - if err != nil { - return nil, err - } - indexProcessor := add_formatted_index.New(timestampFormat) - procs.AddProcessor(indexProcessor) - } - - // 2. User processors - userProcessors, err := processors.New(config.Processors) - if err != nil { - return nil, err - } - procs.AddProcessors(*userProcessors) - - return procs, nil -} diff --git a/x-pack/functionbeat/function/cmd/root.go b/x-pack/functionbeat/function/cmd/root.go deleted file mode 100644 index 75206efbb2c..00000000000 --- a/x-pack/functionbeat/function/cmd/root.go +++ /dev/null @@ -1,54 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package cmd - -import ( - "fmt" - "os" - - "github.com/spf13/cobra" - - "github.com/elastic/beats/v7/libbeat/beat" - "github.com/elastic/beats/v7/libbeat/cfgfile" - "github.com/elastic/beats/v7/libbeat/cmd" - "github.com/elastic/beats/v7/libbeat/cmd/instance" - "github.com/elastic/beats/v7/x-pack/functionbeat/config" -) - -// FunctionCmd is the command of the function. -type FunctionCmd struct { - *cobra.Command - VersionCmd *cobra.Command -} - -// NewFunctionCmd return a new initialized function command. -func NewFunctionCmd(name string, beatCreator beat.Creator) *FunctionCmd { - settings := instance.Settings{ - Name: name, - IndexPrefix: name, - ConfigOverrides: config.FunctionOverrides, - } - - err := cfgfile.ChangeDefaultCfgfileFlag(settings.Name) - if err != nil { - panic(fmt.Errorf("failed to set default config file path: %v", err)) - } - - rootCmd := &FunctionCmd{ - &cobra.Command{ - Run: func(cmd *cobra.Command, args []string) { - err := instance.Run(settings, beatCreator) - if err != nil { - os.Exit(1) - } - }, - }, - cmd.GenVersionCmd(settings), - } - - rootCmd.AddCommand(rootCmd.VersionCmd) - - return rootCmd -} diff --git a/x-pack/functionbeat/function/core/coordinator.go b/x-pack/functionbeat/function/core/coordinator.go deleted file mode 100644 index b7cf2e716be..00000000000 --- a/x-pack/functionbeat/function/core/coordinator.go +++ /dev/null @@ -1,98 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package core - -import ( - "context" - "fmt" - - "github.com/joeshaw/multierror" - - "github.com/elastic/beats/v7/x-pack/functionbeat/function/telemetry" - "github.com/elastic/elastic-agent-libs/logp" -) - -// Runner is the interface that the coordinator will follow to manage a function goroutine. -type Runner interface { - fmt.Stringer - Run(context.Context, telemetry.T) error -} - -// Coordinator takes care of managing the function goroutine, it receives the list of functions that -// need to be executed and manage the goroutine. If an error happen and its not handled by the -// function, we assume its a fatal error and we will -// stop all the other goroutine and functionbeat will terminate. -type Coordinator struct { - log *logp.Logger - runners []Runner -} - -// NewCoordinator create a new coordinator objects receiving the clientFactory and the runner. -func NewCoordinator(log *logp.Logger, - runners ...Runner, -) *Coordinator { - if log == nil { - log = logp.NewLogger("") - } - log = log.Named("Coordinator") - return &Coordinator{log: log, runners: runners} -} - -// Run starts each functions into an independent goroutine and wait until all the goroutine are -// stopped to exit. -func (r *Coordinator) Run(ctx context.Context, t telemetry.T) error { - r.log.Debug("Coordinator is starting") - defer r.log.Debug("Coordinator is stopped") - - // When an errors happen in a function and its not handled by the running function, we log an error - // and we trigger a shutdown of all the others goroutine. - ctx, cancel := context.WithCancel(ctx) - defer cancel() - - results := make(chan error) - defer close(results) - - r.log.Debugf("The coordinator is starting %d functions", len(r.runners)) - for _, rfn := range r.runners { - go func(ctx context.Context, t telemetry.T, rfn Runner) { - var err error - defer func() { results <- err }() - err = r.runFunc(ctx, t, rfn) - if err != nil { - cancel() - } - }(ctx, t, rfn) - } - - // Wait for goroutine to complete and aggregate any errors from the goroutine and - // raise them back to the main program. - var errors multierror.Errors - for range r.runners { - err := <-results - if err != nil { - errors = append(errors, err) - } - } - return errors.Err() -} - -func (r *Coordinator) runFunc( - ctx context.Context, - t telemetry.T, - rfn Runner, -) error { - r.log.Infof("The function '%s' is starting", rfn.String()) - defer r.log.Infof("The function '%s' is stopped", rfn.String()) - - err := rfn.Run(ctx, t) - if err != nil { - r.log.Errorf( - "Nonrecoverable error when executing the function: '%s', error: '%+v', terminating all running functions", - rfn, - err, - ) - } - return err -} diff --git a/x-pack/functionbeat/function/core/coordinator_test.go b/x-pack/functionbeat/function/core/coordinator_test.go deleted file mode 100644 index 71f3356941d..00000000000 --- a/x-pack/functionbeat/function/core/coordinator_test.go +++ /dev/null @@ -1,58 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package core - -import ( - "context" - "errors" - "testing" - - "github.com/stretchr/testify/assert" - - "github.com/elastic/beats/v7/x-pack/functionbeat/function/telemetry" -) - -var errUnhappy = errors.New("unhappy :(") - -type happyRunner struct{} - -func (hr *happyRunner) Run(ctx context.Context, _ telemetry.T) error { - <-ctx.Done() - return nil -} -func (hr *happyRunner) String() string { return "happyRunner" } - -type unhappyRunner struct{} - -func (uhr *unhappyRunner) Run(ctx context.Context, _ telemetry.T) error { - return errUnhappy -} - -func (uhr *unhappyRunner) String() string { return "unhappyRunner" } - -func TestStart(t *testing.T) { - t.Run("start the runner", func(t *testing.T) { - coordinator := NewCoordinator(nil, &happyRunner{}, &happyRunner{}) - ctx, cancel := context.WithCancel(context.Background()) - var err error - go func() { - err = coordinator.Run(ctx, telemetry.Ignored()) - assert.NoError(t, err) - }() - cancel() - }) - - t.Run("on error shutdown all the runner", func(t *testing.T) { - coordinator := NewCoordinator(nil, &happyRunner{}, &unhappyRunner{}) - err := coordinator.Run(context.Background(), telemetry.Ignored()) - assert.Error(t, err) - }) - - t.Run("aggregate all errors", func(t *testing.T) { - coordinator := NewCoordinator(nil, &unhappyRunner{}, &unhappyRunner{}) - err := coordinator.Run(context.Background(), telemetry.Ignored()) - assert.Error(t, err) - }) -} diff --git a/x-pack/functionbeat/function/provider/cli.go b/x-pack/functionbeat/function/provider/cli.go deleted file mode 100644 index 7f112330289..00000000000 --- a/x-pack/functionbeat/function/provider/cli.go +++ /dev/null @@ -1,32 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package provider - -import ( - conf "github.com/elastic/elastic-agent-libs/config" - "github.com/elastic/elastic-agent-libs/logp" -) - -// CLIManager is the interface implemented by each provider to expose a command CLI interface -// to their interface. -type CLIManager interface { - // Deploy takes a function name and deploy functionbeat and the function configuration to the provider. - Deploy(string) error - - //Update takes a function name and update the configuration to the remote provider. - Update(string) error - - // Remove takes a function name and remove the specific function from the remote provider. - Remove(string) error - - // Export prints exported function template to stdout. - Export(string) error - - // Package packages functions for the provider configurable output. - Package(string) error -} - -// CLIManagerFactory factory method to call to create a new CLI manager -type CLIManagerFactory func(*logp.Logger, *conf.C, Provider) (CLIManager, error) diff --git a/x-pack/functionbeat/function/provider/default_provider.go b/x-pack/functionbeat/function/provider/default_provider.go deleted file mode 100644 index 3693d0a718f..00000000000 --- a/x-pack/functionbeat/function/provider/default_provider.go +++ /dev/null @@ -1,112 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package provider - -import ( - "fmt" - - "github.com/elastic/beats/v7/x-pack/functionbeat/config" - "github.com/elastic/beats/v7/x-pack/functionbeat/function/core" - conf "github.com/elastic/elastic-agent-libs/config" - "github.com/elastic/elastic-agent-libs/logp" -) - -// DefaultProvider implements the minimal required to retrieve and start functions. -type DefaultProvider struct { - rawConfig *conf.C - config *config.ProviderConfig - registry *Registry - name string - log *logp.Logger - managerFactory CLIManagerFactory - templateFactory TemplateBuilderFactory -} - -// NewDefaultProvider returns factory methods to handle generic provider. -func NewDefaultProvider( - name string, - manager CLIManagerFactory, - templater TemplateBuilderFactory, -) func(*logp.Logger, *Registry, *conf.C) (Provider, error) { - return func(log *logp.Logger, registry *Registry, cfg *conf.C) (Provider, error) { - c := &config.ProviderConfig{} - err := cfg.Unpack(c) - if err != nil { - return nil, err - } - - if manager == nil { - manager = NewNullCli - } - - return &DefaultProvider{ - rawConfig: cfg, - config: c, - registry: registry, - name: name, - log: log, - managerFactory: manager, - templateFactory: templater, - }, nil - } -} - -// Name returns the name of the provider. -func (d *DefaultProvider) Name() string { - return d.name -} - -// CreateFunctions takes factory method and returns runnable function. -func (d *DefaultProvider) CreateFunctions(clientFactory clientFactory, enabledFunctions []string) ([]core.Runner, error) { - return CreateFunctions(d.registry, d, enabledFunctions, d.config.Functions, clientFactory) -} - -// FindFunctionByName returns a function instance identified by a unique name or an error if not found. -func (d *DefaultProvider) FindFunctionByName(name string) (Function, error) { - return FindFunctionByName(d.registry, d, d.config.Functions, name) -} - -// CLIManager returns the type responsable of installing, updating and removing remote function -// for a specific provider. -func (d *DefaultProvider) CLIManager() (CLIManager, error) { - return d.managerFactory(nil, d.rawConfig, d) -} - -// TemplateBuilder returns a TemplateBuilder returns a the type responsible to generate templates. -func (d *DefaultProvider) TemplateBuilder() (TemplateBuilder, error) { - return d.templateFactory(d.log, d.rawConfig, d) -} - -// EnabledFunctions return the list of enabled funcionts. -func (d *DefaultProvider) EnabledFunctions() ([]string, error) { - return EnabledFunctions(d.registry, d, d.config.Functions) -} - -// nullCLI is used when a provider doesn't implement the CLI to manager functions on the service provider. -type nullCLI struct{} - -// NewNullCli returns a NOOP CliManager. -func NewNullCli(_ *logp.Logger, _ *conf.C, _ Provider) (CLIManager, error) { - return (*nullCLI)(nil), nil -} - -func (*nullCLI) Deploy(_ string) error { return fmt.Errorf("deploy not implemented") } -func (*nullCLI) Update(_ string) error { return fmt.Errorf("update not implemented") } -func (*nullCLI) Remove(_ string) error { return fmt.Errorf("remove not implemented") } -func (*nullCLI) Export(_ string) error { return fmt.Errorf("export not implemented") } -func (*nullCLI) Package(_ string) error { return fmt.Errorf("package not implemented") } - -// nullTemplateBuilder is used when a provider does not implement a template builder functionality. -type nullTemplateBuilder struct{} - -// NewNullTemplateBuilder returns a NOOP TemplateBuilder. -func NewNullTemplateBuilder(_ *logp.Logger, _ *conf.C, _ Provider) (TemplateBuilder, error) { - return (*nullTemplateBuilder)(nil), nil -} - -// RawTemplate returns a empty string. -func (*nullTemplateBuilder) RawTemplate(_ string) (string, error) { - return "", fmt.Errorf("raw temaplate not implemented") -} diff --git a/x-pack/functionbeat/function/provider/feature.go b/x-pack/functionbeat/function/provider/feature.go deleted file mode 100644 index 34c381b2471..00000000000 --- a/x-pack/functionbeat/function/provider/feature.go +++ /dev/null @@ -1,64 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package provider - -import ( - "github.com/elastic/beats/v7/libbeat/feature" -) - -// getNamespace return the namespace for functions of a specific provider. The registry have a flat view -// representation of the plugin world this mean we don't really have a tree, instead what we do is -// to create a unique keys per providers that will only keep the functions of the provider. -func getNamespace(provider string) string { - return namespace + "." + provider + ".functions" -} - -// newFeature creates a new Provider feature to be added to the global registry. -// The namespace will be 'functionbeat.provider' in the registry. -func newFeature(name string, factory Factory) *feature.Feature { - return feature.New(namespace, name, factory) -} - -// newFunctionFeature Feature creates a new function feature to be added to the global registry -// The namespace will be 'functionbeat.provider.local' in the registry. -func newFunctionFeature( - provider, name string, - factory FunctionFactory, -) *feature.Feature { - return feature.New(getNamespace(provider), name, factory) -} - -// builder is used to have a fluent interface to build a set of function for a specific provider, it -// provides a fluent interface to the developper of provider and functions, it wraps the Feature -// functions to make sure the namespace are correctly configured. -type builder struct { - name string - features []feature.Featurable -} - -// Builder creates a new provider builder, it is used to define a provider and the function -// it supports. -func Builder(name string, factory Factory, details feature.Details) *builder { - return &builder{ - name: name, - features: []feature.Featurable{ - newFeature(name, factory), - }, - } -} - -func (b *builder) Features() []feature.Featurable { - return b.features -} - -// AddFunction adds a new function type to the provider and return the builder. -func (b *builder) AddFunction( - name string, - factory FunctionFactory, - details feature.Details, -) *builder { - b.features = append(b.features, newFunctionFeature(b.name, name, factory)) - return b -} diff --git a/x-pack/functionbeat/function/provider/feature_test.go b/x-pack/functionbeat/function/provider/feature_test.go deleted file mode 100644 index a0b8a6d7fcb..00000000000 --- a/x-pack/functionbeat/function/provider/feature_test.go +++ /dev/null @@ -1,51 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package provider - -import ( - "testing" - - "github.com/stretchr/testify/assert" - "github.com/stretchr/testify/require" - - "github.com/elastic/beats/v7/libbeat/feature" - conf "github.com/elastic/elastic-agent-libs/config" - "github.com/elastic/elastic-agent-libs/logp" -) - -func TestBuilder(t *testing.T) { - provider := "myprovider" - providerFactory := func(_ *logp.Logger, _ *Registry, _ *conf.C) (Provider, error) { - return nil, nil - } - - fnFactory1 := func(_ Provider, _ *conf.C) (Function, error) { return nil, nil } - fnFactory2 := func(_ Provider, _ *conf.C) (Function, error) { return nil, nil } - - features := Builder( - provider, - providerFactory, - feature.MakeDetails("myprovider", "myprovider", feature.Experimental), - ).AddFunction( - "f1", - fnFactory1, - feature.MakeDetails("fn1 description", "fn1", feature.Experimental), - ).AddFunction("f2", fnFactory2, feature.MakeDetails( - "fn1 description", - "fn1", - feature.Experimental, - )).Features() - - require.Equal(t, 3, len(features)) - - assert.Equal(t, "myprovider", features[0].Name()) - assert.Equal(t, "functionbeat.provider", features[0].Namespace()) - - assert.Equal(t, "f1", features[1].Name()) - assert.Equal(t, "functionbeat.provider.myprovider.functions", features[1].Namespace()) - - assert.Equal(t, "f2", features[2].Name()) - assert.Equal(t, "functionbeat.provider.myprovider.functions", features[2].Namespace()) -} diff --git a/x-pack/functionbeat/function/provider/provider.go b/x-pack/functionbeat/function/provider/provider.go deleted file mode 100644 index 6c33eb80b1a..00000000000 --- a/x-pack/functionbeat/function/provider/provider.go +++ /dev/null @@ -1,133 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package provider - -import ( - "context" - "fmt" - - "github.com/elastic/beats/v7/libbeat/feature" - "github.com/elastic/beats/v7/libbeat/publisher/pipeline" - "github.com/elastic/beats/v7/x-pack/functionbeat/function/core" - "github.com/elastic/beats/v7/x-pack/functionbeat/function/telemetry" - conf "github.com/elastic/elastic-agent-libs/config" - "github.com/elastic/elastic-agent-libs/logp" -) - -// Create a new pipeline client based on the function configuration. -type clientFactory func(*conf.C) (pipeline.ISyncClient, error) - -// Function is temporary -type Function interface { - Run(context.Context, pipeline.ISyncClient, telemetry.T) error - Name() string -} - -// Provider providers the layer between functionbeat and cloud specific settings, its is responsable to -// return the function that need to be executed. -type Provider interface { - CreateFunctions(clientFactory, []string) ([]core.Runner, error) - FindFunctionByName(string) (Function, error) - EnabledFunctions() ([]string, error) - CLIManager() (CLIManager, error) - TemplateBuilder() (TemplateBuilder, error) - Name() string -} - -// Runnable is the unit of work managed by the coordinator, anything related to the life of a function -// is encapsulated into the runnable. -type Runnable struct { - config *conf.C - function Function - makeClient clientFactory -} - -// Run call the the function's Run method, the method is a specific goroutine, it will block until -// beats shutdown or an error happen. -func (r *Runnable) Run(ctx context.Context, t telemetry.T) error { - client, err := r.makeClient(r.config) - if err != nil { - return fmt.Errorf("could not create a client for the function: %w", err) - } - defer client.Close() - return r.function.Run(ctx, client, t) -} - -func (r *Runnable) String() string { - return r.function.Name() -} - -// NewProvider return the provider specified in the configuration or an error. -func NewProvider(name string, cfg *conf.C) (Provider, error) { - // Configure the provider, the provider will take care of the configuration for the - // functions. - registry := NewRegistry(feature.GlobalRegistry()) - providerFunc, err := registry.Lookup(name) - if err != nil { - return nil, fmt.Errorf("error finding the provider '%s', error: %v", name, err) - } - - provider, err := providerFunc(logp.NewLogger("provider"), registry, cfg) - if err != nil { - return nil, fmt.Errorf("error creating the provider '%s', error: %v", name, err) - } - - return provider, nil -} - -// IsAvailable checks if a cloud provider is available in the binary. -func IsAvailable(name string) (bool, error) { - registry := NewRegistry(feature.GlobalRegistry()) - - availableProviders, err := registry.AvailableProviders() - if err != nil { - return false, err - } - - for _, p := range availableProviders { - if p == name { - return true, nil - } - } - return false, nil -} - -// ListFunctions returns the list of enabled function names. -func ListFunctions(provider string) ([]string, error) { - functions, err := feature.GlobalRegistry().LookupAll(getNamespace(provider)) - if err != nil { - return nil, err - } - - names := make([]string, len(functions)) - for i, f := range functions { - names[i] = f.Name() - } - return names, nil -} - -// Create returns the provider from a configuration. -func Create(cfg *conf.C) (Provider, error) { - providers, err := List() - if err != nil { - return nil, err - } - if len(providers) != 1 { - return nil, fmt.Errorf("too many providers are available, expected one, got: %s", providers) - } - - providerCfg, err := cfg.Child(providers[0], -1) - if err != nil { - return nil, err - } - - return NewProvider(providers[0], providerCfg) -} - -// List returns the list of available providers. -func List() ([]string, error) { - registry := NewRegistry(feature.GlobalRegistry()) - return registry.AvailableProviders() -} diff --git a/x-pack/functionbeat/function/provider/provider_test.go b/x-pack/functionbeat/function/provider/provider_test.go deleted file mode 100644 index 47385cbb029..00000000000 --- a/x-pack/functionbeat/function/provider/provider_test.go +++ /dev/null @@ -1,74 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package provider - -import ( - "context" - "errors" - "testing" - - "github.com/stretchr/testify/assert" - - "github.com/elastic/beats/v7/libbeat/beat" - "github.com/elastic/beats/v7/libbeat/publisher/pipeline" - "github.com/elastic/beats/v7/x-pack/functionbeat/function/telemetry" - conf "github.com/elastic/elastic-agent-libs/config" -) - -type simpleFunction struct { - err error -} - -func (s *simpleFunction) Run(ctx context.Context, client pipeline.ISyncClient, _ telemetry.T) error { - return s.err -} - -func (s *simpleFunction) Name() string { - return "simpleFunction" -} - -type mockClient struct{} - -func (sc *mockClient) Publish(event beat.Event) error { return nil } -func (sc *mockClient) PublishAll(events []beat.Event) error { return nil } -func (sc *mockClient) Close() error { return nil } -func (sc *mockClient) Wait() {} - -func TestRunnable(t *testing.T) { - t.Run("return an error when we cannot create the client", func(t *testing.T) { - err := errors.New("oops") - runnable := Runnable{ - config: conf.NewConfig(), - makeClient: func(cfg *conf.C) (pipeline.ISyncClient, error) { return nil, err }, - function: &simpleFunction{err: nil}, - } - - errReceived := runnable.Run(context.Background(), telemetry.Ignored()) - assert.Equal(t, "could not create a client for the function: "+err.Error(), errReceived.Error()) - }) - - t.Run("propagate functions errors to the coordinator", func(t *testing.T) { - err := errors.New("function error") - runnable := Runnable{ - config: conf.NewConfig(), - makeClient: func(cfg *conf.C) (pipeline.ISyncClient, error) { return &mockClient{}, nil }, - function: &simpleFunction{err: err}, - } - - errReceived := runnable.Run(context.Background(), telemetry.Ignored()) - assert.Equal(t, err.Error(), errReceived.Error()) - }) - - t.Run("when there is no error run and exit normaly", func(t *testing.T) { - runnable := Runnable{ - config: conf.NewConfig(), - makeClient: func(cfg *conf.C) (pipeline.ISyncClient, error) { return &mockClient{}, nil }, - function: &simpleFunction{err: nil}, - } - - errReceived := runnable.Run(context.Background(), telemetry.Ignored()) - assert.NoError(t, errReceived) - }) -} diff --git a/x-pack/functionbeat/function/provider/registry.go b/x-pack/functionbeat/function/provider/registry.go deleted file mode 100644 index 4cd1575cac0..00000000000 --- a/x-pack/functionbeat/function/provider/registry.go +++ /dev/null @@ -1,217 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package provider - -import ( - "errors" - "fmt" - - "github.com/elastic/beats/v7/libbeat/feature" - "github.com/elastic/beats/v7/x-pack/functionbeat/config" - "github.com/elastic/beats/v7/x-pack/functionbeat/function/core" - conf "github.com/elastic/elastic-agent-libs/config" - "github.com/elastic/elastic-agent-libs/logp" -) - -// Errors generated by the registry when we are retrieving providers or functions from the main registry. -var ( - errInvalidProvider = errors.New("invalid provider name") - errInvalidFunctionName = errors.New("invalid function name") - errInvalidType = errors.New("incomptible type received for the feature") -) - -// namespace is the namespace were providers will be registered in the global registry. -const namespace = "functionbeat.provider" - -// Factory factory to create a concrete provider for a specific cloud service. -type Factory func(*logp.Logger, *Registry, *conf.C) (Provider, error) - -// FunctionFactory factory to create a concrete function. -type FunctionFactory func(Provider, *conf.C) (Function, error) - -// Registry is a wrapper around the global feature registry and will take care of returning the -// the right providers and will do the type assertion for the providers, we hide the fact that -// we are actually accessing a global registry. -type Registry struct { - registry *feature.Registry -} - -// NewRegistry return a new registry. -func NewRegistry(registry *feature.Registry) *Registry { - return &Registry{registry: registry} -} - -// Lookup search the registry for the specific provider, normalization is done inside the -// registry to deal with lower case and uppercase. -func (r *Registry) Lookup(name string) (Factory, error) { - if len(name) == 0 { - return nil, errInvalidProvider - } - - f, err := r.registry.Lookup(namespace, name) - if err != nil { - return nil, err - } - - p, ok := f.Factory().(Factory) - if !ok { - return nil, errInvalidType - } - - return p, nil -} - -// LookupFunction takes a provider and a function and return the corresponding type or an -// error if the function or the provider is not found. -func (r *Registry) LookupFunction(provider, function string) (FunctionFactory, error) { - if len(provider) == 0 { - return nil, errInvalidProvider - } - if len(function) == 0 { - return nil, errInvalidFunctionName - } - - if _, err := r.Lookup(provider); err != nil { - return nil, err - } - - ns := getNamespace(provider) - - f, err := r.registry.Lookup(ns, function) - if err != nil { - return nil, err - } - - fn, ok := f.Factory().(FunctionFactory) - if !ok { - return nil, errInvalidType - } - - return fn, nil -} - -// AvailableProviders returns the names of registered providers. -func (r *Registry) AvailableProviders() ([]string, error) { - providerFeatures, err := r.registry.LookupAll(namespace) - if err != nil { - return nil, err - } - - var providers []string - for _, f := range providerFeatures { - providers = append(providers, f.Name()) - } - - return providers, nil -} - -// CreateFunctions create runnable function based on the configurations received. -func CreateFunctions( - registry *Registry, - provider Provider, - enabledFunctions []string, - configs []*conf.C, - clientFactory clientFactory, -) ([]core.Runner, error) { - var runners []core.Runner - - for _, cfg := range configs { - c := config.DefaultFunctionConfig - err := cfg.Unpack(&c) - if err != nil { - return nil, err - } - - if strInSlice(enabledFunctions, c.Name.String()) == -1 { - continue - } - - if !c.Enabled { - return nil, fmt.Errorf("function '%s' not enabled for provider '%s'", c.Name, provider.Name()) - } - - f, err := registry.LookupFunction(provider.Name(), c.Type) - if err != nil { - return nil, err - } - - fn, err := f(provider, cfg) - if err != nil { - return nil, err - } - - runners = append(runners, &Runnable{config: cfg, makeClient: clientFactory, function: fn}) - } - - if len(runners) == 0 { - return nil, fmt.Errorf("no function are enabled for selected provider: '%s'", provider.Name()) - } - return runners, nil -} - -func strInSlice(haystack []string, name string) int { - for idx, s := range haystack { - if s == name { - return idx - } - } - return -1 -} - -// FindFunctionByName returns a function instance identified by a unique name or an error if not found. -func FindFunctionByName( - registry *Registry, - provider Provider, - configs []*conf.C, - name string, -) (Function, error) { - - for _, cfg := range configs { - c := config.FunctionConfig{} - err := cfg.Unpack(&c) - if err != nil { - return nil, err - } - - if c.Name.String() != name { - continue - } - - if !c.Enabled { - return nil, fmt.Errorf("function '%s' not enabled for provider '%s'", name, provider.Name()) - } - - f, err := registry.LookupFunction(provider.Name(), c.Type) - if err != nil { - return nil, err - } - - fn, err := f(provider, cfg) - if err != nil { - return nil, err - } - return fn, nil - } - - return nil, fmt.Errorf("no function with name '%s' exists", name) -} - -// EnabledFunctions returns the list of enabled functions. -func EnabledFunctions(registry *Registry, provider Provider, configs []*conf.C) ([]string, error) { - var names []string - for _, cfg := range configs { - c := config.FunctionConfig{} - err := cfg.Unpack(&c) - if err != nil { - return names, fmt.Errorf("error while finding enabled functions: %+v", err) - } - - if c.Enabled { - names = append(names, c.Name.String()) - } - } - - return names, nil -} diff --git a/x-pack/functionbeat/function/provider/registry_test.go b/x-pack/functionbeat/function/provider/registry_test.go deleted file mode 100644 index 01c994c6186..00000000000 --- a/x-pack/functionbeat/function/provider/registry_test.go +++ /dev/null @@ -1,274 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package provider - -import ( - "context" - "errors" - "reflect" - "testing" - - "github.com/stretchr/testify/assert" - - "github.com/elastic/beats/v7/libbeat/feature" - "github.com/elastic/beats/v7/libbeat/publisher/pipeline" - "github.com/elastic/beats/v7/x-pack/functionbeat/function/core" - "github.com/elastic/beats/v7/x-pack/functionbeat/function/telemetry" - conf "github.com/elastic/elastic-agent-libs/config" - "github.com/elastic/elastic-agent-libs/logp" -) - -type mockProvider struct { - runners []core.Runner - name string -} - -func (m *mockProvider) CreateFunctions(clientFactory clientFactory, _ []string) ([]core.Runner, error) { - return m.runners, nil -} - -func (m *mockProvider) FindFunctionByName(_ string) (Function, error) { - return nil, errors.New("not found") -} - -func (m *mockProvider) Name() string { return m.name } - -func (m *mockProvider) CLIManager() (CLIManager, error) { return nil, nil } - -func (m *mockProvider) TemplateBuilder() (TemplateBuilder, error) { return nil, nil } - -func (m *mockProvider) EnabledFunctions() ([]string, error) { return []string{}, nil } - -func TestRegistry(t *testing.T) { - t.Run("provider", testProviderLookup) - t.Run("functions", testFunctionLookup) -} - -type mockFunction struct { - name string -} - -func (mf *mockFunction) Run(ctx context.Context, client pipeline.ISyncClient, t telemetry.T) error { - return nil -} -func (mf *mockFunction) Name() string { return mf.name } - -func testProviderLookup(t *testing.T) { - name := "myprovider" - myprovider := &mockProvider{} - - providerFn := func(log *logp.Logger, registry *Registry, config *conf.C) (Provider, error) { - return myprovider, nil - } - - f := newFeature( - name, - providerFn, - ) - - t.Run("adding and retrieving a provider", withRegistry(func( - t *testing.T, - global *feature.Registry, - wrapper *Registry, - ) { - err := global.Register(f) - if !assert.NoError(t, err) { - return - } - - factory, err := wrapper.Lookup(name) - if !assert.NoError(t, err) { - return - } - - // Compare func pointers instead of comparing the function value. - assert.Equal(t, reflect.ValueOf(providerFn).Pointer(), reflect.ValueOf(factory).Pointer()) - })) - - t.Run("retrieving a non existing provider", withRegistry(func( - t *testing.T, - global *feature.Registry, - wrapper *Registry, - ) { - _, err := wrapper.Lookup("unknown") - assert.Error(t, err) - })) - - t.Run("invalid provider name when doing lookup", withRegistry(func( - t *testing.T, - global *feature.Registry, - wrapper *Registry, - ) { - _, err := wrapper.Lookup("") - assert.Error(t, err) - })) -} - -func testFunctionLookup(t *testing.T) { - name := "myprovider" - myprovider := &mockProvider{} - - providerFn := func(log *logp.Logger, registry *Registry, config *conf.C) (Provider, error) { - return myprovider, nil - } - - f := newFeature( - name, - providerFn, - ) - - fnName := "myfunc" - myfunction := &mockFunction{name} - functionFn := func(provider Provider, config *conf.C) (Function, error) { - return myfunction, nil - } - - fnFeature := newFunctionFeature(name, fnName, functionFn) - - t.Run("adding and retrieving a function", withRegistry(func( - t *testing.T, - global *feature.Registry, - wrapper *Registry, - ) { - err := global.Register(f) - if !assert.NoError(t, err) { - return - } - - err = global.Register(fnFeature) - if !assert.NoError(t, err) { - return - } - - factory, err := wrapper.LookupFunction(name, fnName) - if !assert.NoError(t, err) { - return - } - - // Compare func pointers instead of comparing the function value. - assert.Equal(t, reflect.ValueOf(functionFn).Pointer(), reflect.ValueOf(factory).Pointer()) - })) - - t.Run("return an error if the provider doesn't exist", withRegistry(func( - t *testing.T, - global *feature.Registry, - wrapper *Registry, - ) { - err := global.Register(f) - if !assert.NoError(t, err) { - return - } - - err = global.Register(fnFeature) - if !assert.NoError(t, err) { - return - } - - _, err = wrapper.LookupFunction("I do not exist", fnName) - assert.Error(t, err) - })) - - t.Run("return an error if the function doesn't exist", withRegistry(func( - t *testing.T, - global *feature.Registry, - wrapper *Registry, - ) { - err := global.Register(f) - if !assert.NoError(t, err) { - return - } - - err = global.Register(fnFeature) - if !assert.NoError(t, err) { - return - } - - _, err = wrapper.LookupFunction(name, "I do not exist") - assert.Error(t, err) - })) -} - -func withRegistry(fn func(t *testing.T, global *feature.Registry, registry *Registry)) func(t *testing.T) { - return func(t *testing.T) { - global := feature.NewRegistry() - wrapped := NewRegistry(global) - fn(t, global, wrapped) - } -} - -func TestStrInSlice(t *testing.T) { - haystack := []string{"bob", "aline"} - t.Run("when in slice return position", func(t *testing.T) { - assert.Equal(t, 1, strInSlice(haystack, "aline")) - }) - - t.Run("when not in slice return -1", func(t *testing.T) { - assert.Equal(t, -1, strInSlice(haystack, "robert")) - }) -} - -func TestFindFunctionByName(t *testing.T) { - t.Run("when the function is not enabled", withRegistry(func( - t *testing.T, - global *feature.Registry, - wrapper *Registry, - ) { - configs := []*conf.C{ - conf.MustNewConfigFrom(map[string]interface{}{ - "name": "mysqs", - "type": "sqs", - "enabled": false, - }), - } - - myprovider := &mockProvider{} - - _, err := FindFunctionByName(wrapper, myprovider, configs, "mysqs") - assert.Error(t, err) - })) - - t.Run("when the function is enabled", withRegistry(func( - t *testing.T, - global *feature.Registry, - wrapper *Registry, - ) { - fnName := "sqs" - configs := []*conf.C{ - conf.MustNewConfigFrom(map[string]interface{}{ - "name": "mysqs", - "type": fnName, - "enabled": true, - }), - } - - name := "myprovider" - myprovider := &mockProvider{name: name} - - providerFn := func(log *logp.Logger, registry *Registry, config *conf.C) (Provider, error) { - return myprovider, nil - } - f := newFeature(name, providerFn) - - myfunction := &mockFunction{name} - functionFn := func(provider Provider, config *conf.C) (Function, error) { - return myfunction, nil - } - - fnFeature := newFunctionFeature(name, fnName, functionFn) - - err := global.Register(f) - if !assert.NoError(t, err) { - return - } - - err = global.Register(fnFeature) - if !assert.NoError(t, err) { - return - } - - _, err = FindFunctionByName(wrapper, myprovider, configs, "mysqs") - assert.NoError(t, err) - })) -} diff --git a/x-pack/functionbeat/function/provider/template.go b/x-pack/functionbeat/function/provider/template.go deleted file mode 100644 index d313774ccb5..00000000000 --- a/x-pack/functionbeat/function/provider/template.go +++ /dev/null @@ -1,19 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package provider - -import ( - conf "github.com/elastic/elastic-agent-libs/config" - "github.com/elastic/elastic-agent-libs/logp" -) - -// TemplateBuilderFactory factory method to call to create a new template builder. -type TemplateBuilderFactory func(*logp.Logger, *conf.C, Provider) (TemplateBuilder, error) - -// TemplateBuilder generates templates for a given provider. -type TemplateBuilder interface { - // RawTemplate returns a deployable template string. - RawTemplate(string) (string, error) -} diff --git a/x-pack/functionbeat/function/telemetry/telemetry.go b/x-pack/functionbeat/function/telemetry/telemetry.go deleted file mode 100644 index 7bb4f370bf9..00000000000 --- a/x-pack/functionbeat/function/telemetry/telemetry.go +++ /dev/null @@ -1,37 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package telemetry - -import ( - "github.com/elastic/elastic-agent-libs/monitoring" -) - -// T is a telemetry instance -type T interface { - AddTriggeredFunction() -} - -type telemetry struct { - registry *monitoring.Registry - countFunctions *monitoring.Int -} - -// New returns a new telemetry registry. -func New(r *monitoring.Registry) T { - return &telemetry{ - registry: r.NewRegistry("functions"), - countFunctions: monitoring.NewInt(r, "count"), - } -} - -// Ignored is used when the package is not monitored. -func Ignored() T { - return nil -} - -// AddTriggeredFunction adds a triggered function data to the registry. -func (t *telemetry) AddTriggeredFunction() { - t.countFunctions.Inc() -} diff --git a/x-pack/functionbeat/functionbeat.reference.yml b/x-pack/functionbeat/functionbeat.reference.yml deleted file mode 100644 index a3df78c4e2d..00000000000 --- a/x-pack/functionbeat/functionbeat.reference.yml +++ /dev/null @@ -1,1573 +0,0 @@ -########################## Functionbeat Configuration ########################### - -# This file is a full configuration example documenting all non-deprecated -# options in comments. For a shorter configuration example, that contains only -# the most common options, please see functionbeat.yml in the same directory. -# -# You can find the full configuration reference here: -# https://www.elastic.co/guide/en/beats/functionbeat/index.html - -# ================================== Provider ================================== -# Configure functions to run on AWS Lambda, currently, we assume that the credentials -# are present in the environment to correctly create the function when using the CLI. -# -# Configure which S3 endpoint should we use. -functionbeat.provider.aws.endpoint: "s3.amazonaws.com" -# Configure which S3 bucket we should upload the lambda artifact. -functionbeat.provider.aws.deploy_bucket: "functionbeat-deploy" - -# Configure credentials of Functionbeat while deploying to AWS. -# Available options: -# * access_key_id, secret_access_key and/or session_token -#functionbeat.provider.aws.access_key_id: '${AWS_ACCESS_KEY_ID:""}' -#functionbeat.provider.aws.secret_access_key: '${AWS_SECRET_ACCESS_KEY:""}' -#functionbeat.provider.aws.session_token: '${AWS_SESSION_TOKEN:""}' -# * role_arn -#functionbeat.provider.aws.role_arn: arn:aws:iam::123456789012:role/test-fnb -# * credential_profile_name and/or shared_credential_file -#functionbeat.provider.aws.credential_profile_name: fnb-aws -#functionbeat.provider.aws.shared_credential_file: /etc/functionbeat/aws_credentials - -functionbeat.provider.aws.functions: - # Define the list of functions available, each function is required to have a unique name. - # Create a function that accepts events coming from cloudwatchlogs. - - name: cloudwatch - enabled: false - type: cloudwatch_logs - - # Description of the method to help identify them when you run multiple functions. - description: "lambda function for cloudwatch logs" - - # Concurrency, is the reserved number of instances for that function. - # Default is 5. - # - # Note: There is a hard limit of 1000 functions of any kind per account. - #concurrency: 5 - - # The maximum memory allocated for this function, the configured size must be a factor of 64. - # There is a hard limit of 3008MiB for each function. Default is 128MiB. - #memory_size: 128MiB - - # The amount of time the function is allowed to run. - #timeout: 3s - - # Execution role of the function. - #role: arn:aws:iam::123456789012:role/MyFunction - - # Connect to private resources in an Amazon VPC. - #virtual_private_cloud: - # security_group_ids: [] - # subnet_ids: [] - - # Dead letter queue configuration, this must be set to an ARN pointing to an SQS queue. - #dead_letter_config.target_arn: - - # Tags are key-value pairs attached to the function. - #tags: - # department: ops - - # Optional fields that you can specify to add additional information to the - # output. Fields can be scalar values, arrays, dictionaries, or any nested - # combination of these. - #fields: - # env: staging - - # List of cloudwatch log group registered to that function. - triggers: - - log_group_name: /aws/lambda/functionbeat-cloudwatch - #filter_pattern: mylog_ - - # Define custom processors for this function. - #processors: - # - dissect: - # tokenizer: "%{key1} %{key2}" - - # Set to true to publish fields with null values in events. - #keep_null: false - - # Create a function that accepts events from SQS queues. - - name: sqs - enabled: false - type: sqs - - # Description of the method to help identify them when you run multiple functions. - description: "lambda function for SQS events" - - # Concurrency, is the reserved number of instances for that function. - # Default is 5. - # - # Note: There is a hard limit of 1000 functions of any kind per account. - #concurrency: 5 - - # The maximum memory allocated for this function, the configured size must be a factor of 64. - # There is a hard limit of 3008MiB for each function. Default is 128MiB. - #memory_size: 128MiB - - # The amount of time the function is allowed to run. - #timeout: 3s - - # Execution role of the function. - #role: arn:aws:iam::123456789012:role/MyFunction - - # Connect to private resources in an Amazon VPC. - #virtual_private_cloud: - # security_group_ids: [] - # subnet_ids: [] - - # Dead letter queue configuration, this must be set to an ARN pointing to an SQS queue. - #dead_letter_config.target_arn: - - # Tags are key-value pairs attached to the function. - #tags: - # department: ops - - # Optional fields that you can specify to add additional information to the - # output. Fields can be scalar values, arrays, dictionaries, or any nested - # combination of these. - #fields: - # env: staging - - # List of SQS queues. - triggers: - # Arn for the SQS queue. - - event_source_arn: arn:aws:sqs:us-east-1:xxxxx:myevents - - # Define custom processors for this function. - #processors: - # - decode_json_fields: - # fields: ["message"] - # process_array: false - # max_depth: 1 - # target: "" - # overwrite_keys: false - # - - # Set to true to publish fields with null values in events. - #keep_null: false - - # Create a function that accepts events from Kinesis streams. - - name: kinesis - enabled: false - type: kinesis - - # Description of the method to help identify them when you run multiple functions. - description: "lambda function for Kinesis events" - - # Concurrency, is the reserved number of instances for that function. - # Default is 5. - # - # Note: There is a hard limit of 1000 functions of any kind per account. - #concurrency: 5 - - # The maximum memory allocated for this function, the configured size must be a factor of 64. - # There is a hard limit of 3008MiB for each function. Default is 128MiB. - #memory_size: 128MiB - - # The amount of time the function is allowed to run. - #timeout: 3s - - # Execution role of the function. - #role: arn:aws:iam::123456789012:role/MyFunction - - # Connect to private resources in an Amazon VPC. - #virtual_private_cloud: - # security_group_ids: [] - # subnet_ids: [] - - # Dead letter queue configuration, this must be set to an ARN pointing to an SQS queue. - #dead_letter_config.target_arn: - - # Tags are key-value pairs attached to the function. - #tags: - # department: ops - - # Optional fields that you can specify to add additional information to the - # output. Fields can be scalar values, arrays, dictionaries, or any nested - # combination of these. - #fields: - # env: staging - - # Define custom processors for this function. - #processors: - # This example extracts the raw data from events. - # - decode_base64_field: - # field: - # from: message - # to: message - # - decompress_gzip_field: - # field: - # from: message - # to: message - # - decode_json_fields: - # fields: ["message"] - # process_array: false - # max_depth: 1 - # target: "" - # overwrite_keys: false - - # List of Kinesis streams. - triggers: - # Arn for the Kinesis stream. - - event_source_arn: arn:aws:kinesis:us-east-1:xxxxx:myevents - - # batch_size is the number of events read in a batch. - # Default is 10. - #batch_size: 100 - - # Starting position is where to start reading events from the Kinesis stream. - # Default is trim_horizon. - #starting_position: "trim_horizon" - - # parallelization_factor is the number of batches to process from each shard concurrently. - # Default is 1. - #parallelization_factor: 1 - - # Set to true to publish fields with null values in events. - #keep_null: false - - # Create a function that accepts Cloudwatch logs from Kinesis streams. - - name: cloudwatch-logs-kinesis - enabled: false - type: cloudwatch_logs_kinesis - - # Description of the method to help identify them when you run multiple functions. - description: "lambda function for Cloudwatch logs in Kinesis events" - - # Set base64_encoded if your data is base64 encoded. - #base64_encoded: false - - # Set compressed if your data is compressed with gzip. - #compressed: true - - # Concurrency, is the reserved number of instances for that function. - # Default is 5. - # - # Note: There is a hard limit of 1000 functions of any kind per account. - #concurrency: 5 - - # The maximum memory allocated for this function, the configured size must be a factor of 64. - # There is a hard limit of 3008MiB for each function. Default is 128MiB. - #memory_size: 128MiB - - # Dead letter queue configuration, this must be set to an ARN pointing to an SQS queue. - #dead_letter_config.target_arn: - - # Tags are key-value pairs attached to the function. - #tags: - # department: ops - - # The amount of time the function is allowed to run. - #timeout: 3s - - # Execution role of the function. - #role: arn:aws:iam::123456789012:role/MyFunction - - # Connect to private resources in an Amazon VPC. - #virtual_private_cloud: - # security_group_ids: [] - # subnet_ids: [] - # - # Define custom processors for this function. - #processors: - # - decode_json_fields: - # fields: ["message"] - # process_array: false - # max_depth: 1 - # target: "" - # overwrite_keys: false - - # List of Kinesis streams. - triggers: - # Arn for the Kinesis stream. - - event_source_arn: arn:aws:kinesis:us-east-1:xxxxx:myevents - - # batch_size is the number of events read in a batch. - # Default is 10. - #batch_size: 100 - - # Starting position is where to start reading events from the Kinesis stream. - # Default is trim_horizon. - #starting_position: "trim_horizon" - - # parallelization_factor is the number of batches to process from each shard concurrently. - # Default is 1. - #parallelization_factor: 1 - - # Set to true to publish fields with null values in events. - #keep_null: false - -# ================================== General =================================== - -# The name of the shipper that publishes the network data. It can be used to group -# all the transactions sent by a single shipper in the web interface. -# If this option is not defined, the hostname is used. -#name: - -# The tags of the shipper are included in their field with each -# transaction published. Tags make it easy to group servers by different -# logical properties. -#tags: ["service-X", "web-tier"] - -# Optional fields that you can specify to add additional information to the -# output. Fields can be scalar values, arrays, dictionaries, or any nested -# combination of these. -#fields: -# env: staging - -# If this option is set to true, the custom fields are stored as top-level -# fields in the output document instead of being grouped under a field -# sub-dictionary. Default is false. -#fields_under_root: false - -# Configure the precision of all timestamps in Functionbeat. -# Available options: millisecond, microsecond, nanosecond -#timestamp.precision: millisecond - -# Internal queue configuration for buffering events to be published. -# Queue settings may be overridden by performance presets in the -# Elasticsearch output. To configure them manually use "preset: custom". -#queue: - # Queue type by name (default 'mem') - # The memory queue will present all available events (up to the outputs - # bulk_max_size) to the output, the moment the output is ready to serve - # another batch of events. - #mem: - # Max number of events the queue can buffer. - #events: 3200 - - # Hints the minimum number of events stored in the queue, - # before providing a batch of events to the outputs. - # The default value is set to 2048. - # A value of 0 ensures events are immediately available - # to be sent to the outputs. - #flush.min_events: 1600 - - # Maximum duration after which events are available to the outputs, - # if the number of events stored in the queue is < `flush.min_events`. - #flush.timeout: 10s - - # The disk queue stores incoming events on disk until the output is - # ready for them. This allows a higher event limit than the memory-only - # queue and lets pending events persist through a restart. - #disk: - # The directory path to store the queue's data. - #path: "${path.data}/diskqueue" - - # The maximum space the queue should occupy on disk. Depending on - # input settings, events that exceed this limit are delayed or discarded. - #max_size: 10GB - - # The maximum size of a single queue data file. Data in the queue is - # stored in smaller segments that are deleted after all their events - # have been processed. - #segment_size: 1GB - - # The number of events to read from disk to memory while waiting for - # the output to request them. - #read_ahead: 512 - - # The number of events to accept from inputs while waiting for them - # to be written to disk. If event data arrives faster than it - # can be written to disk, this setting prevents it from overflowing - # main memory. - #write_ahead: 2048 - - # The duration to wait before retrying when the queue encounters a disk - # write error. - #retry_interval: 1s - - # The maximum length of time to wait before retrying on a disk write - # error. If the queue encounters repeated errors, it will double the - # length of its retry interval each time, up to this maximum. - #max_retry_interval: 30s - -# Sets the maximum number of CPUs that can be executed simultaneously. The -# default is the number of logical CPUs available in the system. -#max_procs: - -# ================================= Processors ================================= - -# Processors are used to reduce the number of fields in the exported event or to -# enhance the event with external metadata. This section defines a list of -# processors that are applied one by one and the first one receives the initial -# event: -# -# event -> filter1 -> event1 -> filter2 ->event2 ... -# -# The supported processors are drop_fields, drop_event, include_fields, -# decode_json_fields, and add_cloud_metadata. -# -# For example, you can use the following processors to keep the fields that -# contain CPU load percentages, but remove the fields that contain CPU ticks -# values: -# -#processors: -# - include_fields: -# fields: ["cpu"] -# - drop_fields: -# fields: ["cpu.user", "cpu.system"] -# -# The following example drops the events that have the HTTP response code 200: -# -#processors: -# - drop_event: -# when: -# equals: -# http.code: 200 -# -# The following example renames the field a to b: -# -#processors: -# - rename: -# fields: -# - from: "a" -# to: "b" -# -# The following example tokenizes the string into fields: -# -#processors: -# - dissect: -# tokenizer: "%{key1} - %{key2}" -# field: "message" -# target_prefix: "dissect" -# -# The following example enriches each event with metadata from the cloud -# provider about the host machine. It works on EC2, GCE, DigitalOcean, -# Tencent Cloud, and Alibaba Cloud. -# -#processors: -# - add_cloud_metadata: ~ -# -# The following example enriches each event with the machine's local time zone -# offset from UTC. -# -#processors: -# - add_locale: -# format: offset -# -# The following example enriches each event with docker metadata, it matches -# given fields to an existing container id and adds info from that container: -# -#processors: -# - add_docker_metadata: -# host: "unix:///var/run/docker.sock" -# match_fields: ["system.process.cgroup.id"] -# match_pids: ["process.pid", "process.parent.pid"] -# match_source: true -# match_source_index: 4 -# match_short_id: false -# cleanup_timeout: 60 -# labels.dedot: false -# # To connect to Docker over TLS you must specify a client and CA certificate. -# #ssl: -# # certificate_authority: "/etc/pki/root/ca.pem" -# # certificate: "/etc/pki/client/cert.pem" -# # key: "/etc/pki/client/cert.key" -# -# The following example enriches each event with docker metadata, it matches -# container id from log path available in `source` field (by default it expects -# it to be /var/lib/docker/containers/*/*.log). -# -#processors: -# - add_docker_metadata: ~ -# -# The following example enriches each event with host metadata. -# -#processors: -# - add_host_metadata: ~ -# -# The following example enriches each event with process metadata using -# process IDs included in the event. -# -#processors: -# - add_process_metadata: -# match_pids: ["system.process.ppid"] -# target: system.process.parent -# -# The following example decodes fields containing JSON strings -# and replaces the strings with valid JSON objects. -# -#processors: -# - decode_json_fields: -# fields: ["field1", "field2", ...] -# process_array: false -# max_depth: 1 -# target: "" -# overwrite_keys: false -# -#processors: -# - decompress_gzip_field: -# from: "field1" -# to: "field2" -# ignore_missing: false -# fail_on_error: true -# -# The following example copies the value of the message to message_copied -# -#processors: -# - copy_fields: -# fields: -# - from: message -# to: message_copied -# fail_on_error: true -# ignore_missing: false -# -# The following example truncates the value of the message to 1024 bytes -# -#processors: -# - truncate_fields: -# fields: -# - message -# max_bytes: 1024 -# fail_on_error: false -# ignore_missing: true -# -# The following example preserves the raw message under event.original -# -#processors: -# - copy_fields: -# fields: -# - from: message -# to: event.original -# fail_on_error: false -# ignore_missing: true -# - truncate_fields: -# fields: -# - event.original -# max_bytes: 1024 -# fail_on_error: false -# ignore_missing: true -# -# The following example URL-decodes the value of field1 to field2 -# -#processors: -# - urldecode: -# fields: -# - from: "field1" -# to: "field2" -# ignore_missing: false -# fail_on_error: true - -# =============================== Elastic Cloud ================================ - -# These settings simplify using Functionbeat with the Elastic Cloud (https://cloud.elastic.co/). - -# The cloud.id setting overwrites the `output.elasticsearch.hosts` and -# `setup.kibana.host` options. -# You can find the `cloud.id` in the Elastic Cloud web UI. -#cloud.id: - -# The cloud.auth setting overwrites the `output.elasticsearch.username` and -# `output.elasticsearch.password` settings. The format is `:`. -#cloud.auth: - -# ================================== Outputs =================================== - -# Configure what output to use when sending the data collected by the beat. - -# ---------------------------- Elasticsearch Output ---------------------------- -output.elasticsearch: - # Boolean flag to enable or disable the output module. - #enabled: true - - # Array of hosts to connect to. - # Scheme and port can be left out and will be set to the default (http and 9200) - # In case you specify and additional path, the scheme is required: http://localhost:9200/path - # IPv6 addresses should always be defined as: https://[2001:db8::1]:9200 - hosts: ["localhost:9200"] - - # Performance presets configure other output fields to recommended values - # based on a performance priority. - # Options are "balanced", "throughput", "scale", "latency" and "custom". - # Default if unspecified: "custom" - preset: balanced - - # Set gzip compression level. Set to 0 to disable compression. - # This field may conflict with performance presets. To set it - # manually use "preset: custom". - # The default is 1. - #compression_level: 1 - - # Configure escaping HTML symbols in strings. - #escape_html: false - - # Protocol - either `http` (default) or `https`. - #protocol: "https" - - # Authentication credentials - either API key or username/password. - #api_key: "id:api_key" - #username: "elastic" - #password: "changeme" - - # Dictionary of HTTP parameters to pass within the URL with index operations. - #parameters: - #param1: value1 - #param2: value2 - - # Number of workers per Elasticsearch host. - # This field may conflict with performance presets. To set it - # manually use "preset: custom". - #worker: 1 - - # If set to true and multiple hosts are configured, the output plugin load - # balances published events onto all Elasticsearch hosts. If set to false, - # the output plugin sends all events to only one host (determined at random) - # and will switch to another host if the currently selected one becomes - # unreachable. The default value is true. - #loadbalance: true - - # Optional data stream or index name. The default is "functionbeat-%{[agent.version]}". - # In case you modify this pattern you must update setup.template.name and setup.template.pattern accordingly. - #index: "functionbeat-%{[agent.version]}" - - # Optional ingest pipeline. By default, no pipeline will be used. - #pipeline: "" - - # Optional HTTP path - #path: "/elasticsearch" - - # Custom HTTP headers to add to each request - #headers: - # X-My-Header: Contents of the header - - # Proxy server URL - #proxy_url: http://proxy:3128 - - # Whether to disable proxy settings for outgoing connections. If true, this - # takes precedence over both the proxy_url field and any environment settings - # (HTTP_PROXY, HTTPS_PROXY). The default is false. - #proxy_disable: false - - # The number of times a particular Elasticsearch index operation is attempted. If - # the indexing operation doesn't succeed after this many retries, the events are - # dropped. The default is 3. - #max_retries: 3 - - # The maximum number of events to bulk in a single Elasticsearch bulk API index request. - # This field may conflict with performance presets. To set it - # manually use "preset: custom". - # The default is 1600. - #bulk_max_size: 1600 - - # The number of seconds to wait before trying to reconnect to Elasticsearch - # after a network error. After waiting backoff.init seconds, the Beat - # tries to reconnect. If the attempt fails, the backoff timer is increased - # exponentially up to backoff.max. After a successful connection, the backoff - # timer is reset. The default is 1s. - #backoff.init: 1s - - # The maximum number of seconds to wait before attempting to connect to - # Elasticsearch after a network error. The default is 60s. - #backoff.max: 60s - - # The maximum amount of time an idle connection will remain idle - # before closing itself. Zero means use the default of 60s. The - # format is a Go language duration (example 60s is 60 seconds). - # This field may conflict with performance presets. To set it - # manually use "preset: custom". - # The default is 3s. - # idle_connection_timeout: 3s - - # Configure HTTP request timeout before failing a request to Elasticsearch. - #timeout: 90 - - # Prevents functionbeat from connecting to older Elasticsearch versions when set to `false` - #allow_older_versions: true - - # Use SSL settings for HTTPS. - #ssl.enabled: true - - # Controls the verification of certificates. Valid values are: - # * full, which verifies that the provided certificate is signed by a trusted - # authority (CA) and also verifies that the server's hostname (or IP address) - # matches the names identified within the certificate. - # * strict, which verifies that the provided certificate is signed by a trusted - # authority (CA) and also verifies that the server's hostname (or IP address) - # matches the names identified within the certificate. If the Subject Alternative - # Name is empty, it returns an error. - # * certificate, which verifies that the provided certificate is signed by a - # trusted authority (CA), but does not perform any hostname verification. - # * none, which performs no verification of the server's certificate. This - # mode disables many of the security benefits of SSL/TLS and should only be used - # after very careful consideration. It is primarily intended as a temporary - # diagnostic mechanism when attempting to resolve TLS errors; its use in - # production environments is strongly discouraged. - # The default value is full. - #ssl.verification_mode: full - - # List of supported/valid TLS versions. By default all TLS versions from 1.1 - # up to 1.3 are enabled. - #ssl.supported_protocols: [TLSv1.1, TLSv1.2, TLSv1.3] - - # List of root certificates for HTTPS server verifications - #ssl.certificate_authorities: ["/etc/pki/root/ca.pem"] - - # Certificate for SSL client authentication - #ssl.certificate: "/etc/pki/client/cert.pem" - - # Client certificate key - #ssl.key: "/etc/pki/client/cert.key" - - # Optional passphrase for decrypting the certificate key. - #ssl.key_passphrase: '' - - # Configure cipher suites to be used for SSL connections - #ssl.cipher_suites: [] - - # Configure curve types for ECDHE-based cipher suites - #ssl.curve_types: [] - - # Configure what types of renegotiation are supported. Valid options are - # never, once, and freely. Default is never. - #ssl.renegotiation: never - - # Configure a pin that can be used to do extra validation of the verified certificate chain, - # this allow you to ensure that a specific certificate is used to validate the chain of trust. - # - # The pin is a base64 encoded string of the SHA-256 fingerprint. - #ssl.ca_sha256: "" - - # A root CA HEX encoded fingerprint. During the SSL handshake if the - # fingerprint matches the root CA certificate, it will be added to - # the provided list of root CAs (`certificate_authorities`), if the - # list is empty or not defined, the matching certificate will be the - # only one in the list. Then the normal SSL validation happens. - #ssl.ca_trusted_fingerprint: "" - - - # Enables restarting functionbeat if any file listed by `key`, - # `certificate`, or `certificate_authorities` is modified. - # This feature IS NOT supported on Windows. - #ssl.restart_on_cert_change.enabled: false - - # Period to scan for changes on CA certificate files - #ssl.restart_on_cert_change.period: 1m - - # Enable Kerberos support. Kerberos is automatically enabled if any Kerberos setting is set. - #kerberos.enabled: true - - # Authentication type to use with Kerberos. Available options: keytab, password. - #kerberos.auth_type: password - - # Path to the keytab file. It is used when auth_type is set to keytab. - #kerberos.keytab: /etc/elastic.keytab - - # Path to the Kerberos configuration. - #kerberos.config_path: /etc/krb5.conf - - # Name of the Kerberos user. - #kerberos.username: elastic - - # Password of the Kerberos user. It is used when auth_type is set to password. - #kerberos.password: changeme - - # Kerberos realm. - #kerberos.realm: ELASTIC - - -# ------------------------------ Logstash Output ------------------------------- -#output.logstash: - # Boolean flag to enable or disable the output module. - #enabled: true - - # The Logstash hosts - #hosts: ["localhost:5044"] - - # Number of workers per Logstash host. - #worker: 1 - - # Set gzip compression level. - #compression_level: 3 - - # Configure escaping HTML symbols in strings. - #escape_html: false - - # Optional maximum time to live for a connection to Logstash, after which the - # connection will be re-established. A value of `0s` (the default) will - # disable this feature. - # - # Not yet supported for async connections (i.e. with the "pipelining" option set) - #ttl: 30s - - # Optionally load-balance events between Logstash hosts. Default is false. - #loadbalance: false - - # Number of batches to be sent asynchronously to Logstash while processing - # new batches. - #pipelining: 2 - - # If enabled only a subset of events in a batch of events is transferred per - # transaction. The number of events to be sent increases up to `bulk_max_size` - # if no error is encountered. - #slow_start: false - - # The number of seconds to wait before trying to reconnect to Logstash - # after a network error. After waiting backoff.init seconds, the Beat - # tries to reconnect. If the attempt fails, the backoff timer is increased - # exponentially up to backoff.max. After a successful connection, the backoff - # timer is reset. The default is 1s. - #backoff.init: 1s - - # The maximum number of seconds to wait before attempting to connect to - # Logstash after a network error. The default is 60s. - #backoff.max: 60s - - # Optional index name. The default index name is set to functionbeat - # in all lowercase. - #index: 'functionbeat' - - # SOCKS5 proxy server URL - #proxy_url: socks5://user:password@socks5-server:2233 - - # Resolve names locally when using a proxy server. Defaults to false. - #proxy_use_local_resolver: false - - # Use SSL settings for HTTPS. - #ssl.enabled: true - - # Controls the verification of certificates. Valid values are: - # * full, which verifies that the provided certificate is signed by a trusted - # authority (CA) and also verifies that the server's hostname (or IP address) - # matches the names identified within the certificate. - # * strict, which verifies that the provided certificate is signed by a trusted - # authority (CA) and also verifies that the server's hostname (or IP address) - # matches the names identified within the certificate. If the Subject Alternative - # Name is empty, it returns an error. - # * certificate, which verifies that the provided certificate is signed by a - # trusted authority (CA), but does not perform any hostname verification. - # * none, which performs no verification of the server's certificate. This - # mode disables many of the security benefits of SSL/TLS and should only be used - # after very careful consideration. It is primarily intended as a temporary - # diagnostic mechanism when attempting to resolve TLS errors; its use in - # production environments is strongly discouraged. - # The default value is full. - #ssl.verification_mode: full - - # List of supported/valid TLS versions. By default all TLS versions from 1.1 - # up to 1.3 are enabled. - #ssl.supported_protocols: [TLSv1.1, TLSv1.2, TLSv1.3] - - # List of root certificates for HTTPS server verifications - #ssl.certificate_authorities: ["/etc/pki/root/ca.pem"] - - # Certificate for SSL client authentication - #ssl.certificate: "/etc/pki/client/cert.pem" - - # Client certificate key - #ssl.key: "/etc/pki/client/cert.key" - - # Optional passphrase for decrypting the certificate key. - #ssl.key_passphrase: '' - - # Configure cipher suites to be used for SSL connections - #ssl.cipher_suites: [] - - # Configure curve types for ECDHE-based cipher suites - #ssl.curve_types: [] - - # Configure what types of renegotiation are supported. Valid options are - # never, once, and freely. Default is never. - #ssl.renegotiation: never - - # Configure a pin that can be used to do extra validation of the verified certificate chain, - # this allow you to ensure that a specific certificate is used to validate the chain of trust. - # - # The pin is a base64 encoded string of the SHA-256 fingerprint. - #ssl.ca_sha256: "" - - # A root CA HEX encoded fingerprint. During the SSL handshake if the - # fingerprint matches the root CA certificate, it will be added to - # the provided list of root CAs (`certificate_authorities`), if the - # list is empty or not defined, the matching certificate will be the - # only one in the list. Then the normal SSL validation happens. - #ssl.ca_trusted_fingerprint: "" - - # Enables restarting functionbeat if any file listed by `key`, - # `certificate`, or `certificate_authorities` is modified. - # This feature IS NOT supported on Windows. - #ssl.restart_on_cert_change.enabled: false - - # Period to scan for changes on CA certificate files - #ssl.restart_on_cert_change.period: 1m - - # The number of times to retry publishing an event after a publishing failure. - # After the specified number of retries, the events are typically dropped. - # Some Beats, such as Filebeat and Winlogbeat, ignore the max_retries setting - # and retry until all events are published. Set max_retries to a value less - # than 0 to retry until all events are published. The default is 3. - #max_retries: 3 - - # The maximum number of events to bulk in a single Logstash request. The - # default is 2048. - #bulk_max_size: 2048 - - # The number of seconds to wait for responses from the Logstash server before - # timing out. The default is 30s. - #timeout: 30s - - - - -# ------------------------------- Console Output ------------------------------- -#output.console: - # Boolean flag to enable or disable the output module. - #enabled: true - - # Configure JSON encoding - #codec.json: - # Pretty-print JSON event - #pretty: false - - # Configure escaping HTML symbols in strings. - #escape_html: false - -# =================================== Paths ==================================== - -# The home path for the Functionbeat installation. This is the default base path -# for all other path settings and for miscellaneous files that come with the -# distribution (for example, the sample dashboards). -# If not set by a CLI flag or in the configuration file, the default for the -# home path is the location of the binary. -#path.home: - -# The configuration path for the Functionbeat installation. This is the default -# base path for configuration files, including the main YAML configuration file -# and the Elasticsearch template file. If not set by a CLI flag or in the -# configuration file, the default for the configuration path is the home path. -#path.config: ${path.home} - -# The data path for the Functionbeat installation. This is the default base path -# for all the files in which Functionbeat needs to store its data. If not set by a -# CLI flag or in the configuration file, the default for the data path is a data -# subdirectory inside the home path. -#path.data: ${path.home}/data - -# The logs path for a Functionbeat installation. This is the default location for -# the Beat's log files. If not set by a CLI flag or in the configuration file, -# the default for the logs path is a logs subdirectory inside the home path. -#path.logs: ${path.home}/logs - -# ================================== Keystore ================================== - -# Location of the Keystore containing the keys and their sensitive values. -#keystore.path: "${path.config}/beats.keystore" - -# ================================= Dashboards ================================= - -# These settings control loading the sample dashboards to the Kibana index. Loading -# the dashboards are disabled by default and can be enabled either by setting the -# options here or by using the `-setup` CLI flag or the `setup` command. -#setup.dashboards.enabled: false - -# The directory from where to read the dashboards. The default is the `kibana` -# folder in the home path. -#setup.dashboards.directory: ${path.home}/kibana - -# The URL from where to download the dashboard archive. It is used instead of -# the directory if it has a value. -#setup.dashboards.url: - -# The file archive (zip file) from where to read the dashboards. It is used instead -# of the directory when it has a value. -#setup.dashboards.file: - -# In case the archive contains the dashboards from multiple Beats, this lets you -# select which one to load. You can load all the dashboards in the archive by -# setting this to the empty string. -#setup.dashboards.beat: functionbeat - -# The name of the Kibana index to use for setting the configuration. Default is ".kibana" -#setup.dashboards.kibana_index: .kibana - -# The Elasticsearch index name. This overwrites the index name defined in the -# dashboards and index pattern. Example: testbeat-* -#setup.dashboards.index: - -# Always use the Kibana API for loading the dashboards instead of autodetecting -# how to install the dashboards by first querying Elasticsearch. -#setup.dashboards.always_kibana: false - -# If true and Kibana is not reachable at the time when dashboards are loaded, -# it will retry to reconnect to Kibana instead of exiting with an error. -#setup.dashboards.retry.enabled: false - -# Duration interval between Kibana connection retries. -#setup.dashboards.retry.interval: 1s - -# Maximum number of retries before exiting with an error, 0 for unlimited retrying. -#setup.dashboards.retry.maximum: 0 - -# ================================== Template ================================== - -# A template is used to set the mapping in Elasticsearch -# By default template loading is enabled and the template is loaded. -# These settings can be adjusted to load your own template or overwrite existing ones. - -# Set to false to disable template loading. -#setup.template.enabled: true - -# Template name. By default the template name is "functionbeat-%{[agent.version]}" -# The template name and pattern has to be set in case the Elasticsearch index pattern is modified. -#setup.template.name: "functionbeat-%{[agent.version]}" - -# Template pattern. By default the template pattern is "functionbeat-%{[agent.version]}" to apply to the default index settings. -# The template name and pattern has to be set in case the Elasticsearch index pattern is modified. -#setup.template.pattern: "functionbeat-%{[agent.version]}" - -# Path to fields.yml file to generate the template -#setup.template.fields: "${path.config}/fields.yml" - -# A list of fields to be added to the template and Kibana index pattern. Also -# specify setup.template.overwrite: true to overwrite the existing template. -#setup.template.append_fields: -#- name: field_name -# type: field_type - -# Enable JSON template loading. If this is enabled, the fields.yml is ignored. -#setup.template.json.enabled: false - -# Path to the JSON template file -#setup.template.json.path: "${path.config}/template.json" - -# Name under which the template is stored in Elasticsearch -#setup.template.json.name: "" - -# Set this option if the JSON template is a data stream. -#setup.template.json.data_stream: false - -# Overwrite existing template -# Do not enable this option for more than one instance of functionbeat as it might -# overload your Elasticsearch with too many update requests. -#setup.template.overwrite: false - -# Elasticsearch template settings -setup.template.settings: - - # A dictionary of settings to place into the settings.index dictionary - # of the Elasticsearch template. For more details, please check - # https://www.elastic.co/guide/en/elasticsearch/reference/current/mapping.html - #index: - #number_of_shards: 1 - #codec: best_compression - - # A dictionary of settings for the _source field. For more details, please check - # https://www.elastic.co/guide/en/elasticsearch/reference/current/mapping-source-field.html - #_source: - #enabled: false - -# ====================== Index Lifecycle Management (ILM) ====================== - -# Configure index lifecycle management (ILM) to manage the backing indices -# of your data streams. - -# Enable ILM support. Valid values are true, or false. -#setup.ilm.enabled: true - -# Set the lifecycle policy name. The default policy name is -# 'beatname'. -#setup.ilm.policy_name: "mypolicy" - -# The path to a JSON file that contains a lifecycle policy configuration. Used -# to load your own lifecycle policy. -#setup.ilm.policy_file: - -# Disable the check for an existing lifecycle policy. The default is true. -# If you set this option to false, lifecycle policy will not be installed, -# even if setup.ilm.overwrite is set to true. -#setup.ilm.check_exists: true - -# Overwrite the lifecycle policy at startup. The default is false. -#setup.ilm.overwrite: false - -# ======================== Data Stream Lifecycle (DSL) ========================= - -# Configure Data Stream Lifecycle to manage data streams while connected to Serverless elasticsearch. -# These settings are mutually exclusive with ILM settings which are not supported in Serverless projects. - -# Enable DSL support. Valid values are true, or false. -#setup.dsl.enabled: true - -# Set the lifecycle policy name or pattern. For DSL, this name must match the data stream that the lifecycle is for. -# The default data stream pattern is functionbeat-%{[agent.version]}" -# The template string `%{[agent.version]}` will resolve to the current stack version. -# The other possible template value is `%{[beat.name]}`. -#setup.dsl.data_stream_pattern: "functionbeat-%{[agent.version]}" - -# The path to a JSON file that contains a lifecycle policy configuration. Used -# to load your own lifecycle policy. -# If no custom policy is specified, a default policy with a lifetime of 7 days will be created. -#setup.dsl.policy_file: - -# Disable the check for an existing lifecycle policy. The default is true. If -# you disable this check, set setup.dsl.overwrite: true so the lifecycle policy -# can be installed. -#setup.dsl.check_exists: true - -# Overwrite the lifecycle policy at startup. The default is false. -#setup.dsl.overwrite: false - -# =================================== Kibana =================================== - -# Starting with Beats version 6.0.0, the dashboards are loaded via the Kibana API. -# This requires a Kibana endpoint configuration. -setup.kibana: - - # Kibana Host - # Scheme and port can be left out and will be set to the default (http and 5601) - # In case you specify and additional path, the scheme is required: http://localhost:5601/path - # IPv6 addresses should always be defined as: https://[2001:db8::1]:5601 - #host: "localhost:5601" - - # Optional protocol and basic auth credentials. - #protocol: "https" - #username: "elastic" - #password: "changeme" - - # Optional HTTP path - #path: "" - - # Optional Kibana space ID. - #space.id: "" - - # Custom HTTP headers to add to each request - #headers: - # X-My-Header: Contents of the header - - # Use SSL settings for HTTPS. - #ssl.enabled: true - - # Controls the verification of certificates. Valid values are: - # * full, which verifies that the provided certificate is signed by a trusted - # authority (CA) and also verifies that the server's hostname (or IP address) - # matches the names identified within the certificate. - # * strict, which verifies that the provided certificate is signed by a trusted - # authority (CA) and also verifies that the server's hostname (or IP address) - # matches the names identified within the certificate. If the Subject Alternative - # Name is empty, it returns an error. - # * certificate, which verifies that the provided certificate is signed by a - # trusted authority (CA), but does not perform any hostname verification. - # * none, which performs no verification of the server's certificate. This - # mode disables many of the security benefits of SSL/TLS and should only be used - # after very careful consideration. It is primarily intended as a temporary - # diagnostic mechanism when attempting to resolve TLS errors; its use in - # production environments is strongly discouraged. - # The default value is full. - #ssl.verification_mode: full - - # List of supported/valid TLS versions. By default all TLS versions from 1.1 - # up to 1.3 are enabled. - #ssl.supported_protocols: [TLSv1.1, TLSv1.2, TLSv1.3] - - # List of root certificates for HTTPS server verifications - #ssl.certificate_authorities: ["/etc/pki/root/ca.pem"] - - # Certificate for SSL client authentication - #ssl.certificate: "/etc/pki/client/cert.pem" - - # Client certificate key - #ssl.key: "/etc/pki/client/cert.key" - - # Optional passphrase for decrypting the certificate key. - #ssl.key_passphrase: '' - - # Configure cipher suites to be used for SSL connections - #ssl.cipher_suites: [] - - # Configure curve types for ECDHE-based cipher suites - #ssl.curve_types: [] - - # Configure what types of renegotiation are supported. Valid options are - # never, once, and freely. Default is never. - #ssl.renegotiation: never - - # Configure a pin that can be used to do extra validation of the verified certificate chain, - # this allow you to ensure that a specific certificate is used to validate the chain of trust. - # - # The pin is a base64 encoded string of the SHA-256 fingerprint. - #ssl.ca_sha256: "" - - # A root CA HEX encoded fingerprint. During the SSL handshake if the - # fingerprint matches the root CA certificate, it will be added to - # the provided list of root CAs (`certificate_authorities`), if the - # list is empty or not defined, the matching certificate will be the - # only one in the list. Then the normal SSL validation happens. - #ssl.ca_trusted_fingerprint: "" - - -# ================================== Logging =================================== - -# There are four options for the log output: file, stderr, syslog, eventlog -# The file output is the default. - -# Sets log level. The default log level is info. -# Available log levels are: error, warning, info, debug -#logging.level: info - -# Enable debug output for selected components. To enable all selectors use ["*"] -# Other available selectors are "beat", "publisher", "service" -# Multiple selectors can be chained. -#logging.selectors: [ ] - -# Send all logging output to stderr. The default is false. -#logging.to_stderr: false - -# Send all logging output to syslog. The default is false. -#logging.to_syslog: false - -# Send all logging output to Windows Event Logs. The default is false. -#logging.to_eventlog: false - -# If enabled, Functionbeat periodically logs its internal metrics that have changed -# in the last period. For each metric that changed, the delta from the value at -# the beginning of the period is logged. Also, the total values for -# all non-zero internal metrics are logged on shutdown. The default is true. -#logging.metrics.enabled: true - -# The period after which to log the internal metrics. The default is 30s. -#logging.metrics.period: 30s - -# A list of metrics namespaces to report in the logs. Defaults to [stats]. -# `stats` contains general Beat metrics. `dataset` may be present in some -# Beats and contains module or input metrics. -#logging.metrics.namespaces: [stats] - -# Logging to rotating files. Set logging.to_files to false to disable logging to -# files. -logging.to_files: true -logging.files: - # Configure the path where the logs are written. The default is the logs directory - # under the home path (the binary location). - #path: /var/log/functionbeat - - # The name of the files where the logs are written to. - #name: functionbeat - - # Configure log file size limit. If the limit is reached, log file will be - # automatically rotated. - #rotateeverybytes: 10485760 # = 10MB - - # Number of rotated log files to keep. The oldest files will be deleted first. - #keepfiles: 7 - - # The permissions mask to apply when rotating log files. The default value is 0600. - # Must be a valid Unix-style file permissions mask expressed in octal notation. - #permissions: 0600 - - # Enable log file rotation on time intervals in addition to the size-based rotation. - # Intervals must be at least 1s. Values of 1m, 1h, 24h, 7*24h, 30*24h, and 365*24h - # are boundary-aligned with minutes, hours, days, weeks, months, and years as - # reported by the local system clock. All other intervals are calculated from the - # Unix epoch. Defaults to disabled. - #interval: 0 - - # Rotate existing logs on startup rather than appending them to the existing - # file. Defaults to true. - # rotateonstartup: true - -#=============================== Events Logging =============================== -# Some outputs will log raw events on errors like indexing errors in the -# Elasticsearch output, to prevent logging raw events (that may contain -# sensitive information) together with other log messages, a different -# log file, only for log entries containing raw events, is used. It will -# use the same level, selectors and all other configurations from the -# default logger, but it will have it's own file configuration. -# -# Having a different log file for raw events also prevents event data -# from drowning out the regular log files. -# -# IMPORTANT: No matter the default logger output configuration, raw events -# will **always** be logged to a file configured by `logging.event_data.files`. - -# logging.event_data: -# Logging to rotating files. Set logging.to_files to false to disable logging to -# files. -#logging.event_data.to_files: true -#logging.event_data: - # Configure the path where the logs are written. The default is the logs directory - # under the home path (the binary location). - #path: /var/log/functionbeat - - # The name of the files where the logs are written to. - #name: functionbeat-event-data - - # Configure log file size limit. If the limit is reached, log file will be - # automatically rotated. - #rotateeverybytes: 5242880 # = 5MB - - # Number of rotated log files to keep. The oldest files will be deleted first. - #keepfiles: 2 - - # The permissions mask to apply when rotating log files. The default value is 0600. - # Must be a valid Unix-style file permissions mask expressed in octal notation. - #permissions: 0600 - - # Enable log file rotation on time intervals in addition to the size-based rotation. - # Intervals must be at least 1s. Values of 1m, 1h, 24h, 7*24h, 30*24h, and 365*24h - # are boundary-aligned with minutes, hours, days, weeks, months, and years as - # reported by the local system clock. All other intervals are calculated from the - # Unix epoch. Defaults to disabled. - #interval: 0 - - # Rotate existing logs on startup rather than appending them to the existing - # file. Defaults to false. - # rotateonstartup: false - -# ============================= X-Pack Monitoring ============================== -# Functionbeat can export internal metrics to a central Elasticsearch monitoring -# cluster. This requires xpack monitoring to be enabled in Elasticsearch. The -# reporting is disabled by default. - -# Set to true to enable the monitoring reporter. -#monitoring.enabled: false - -# Sets the UUID of the Elasticsearch cluster under which monitoring data for this -# Functionbeat instance will appear in the Stack Monitoring UI. If output.elasticsearch -# is enabled, the UUID is derived from the Elasticsearch cluster referenced by output.elasticsearch. -#monitoring.cluster_uuid: - -# Uncomment to send the metrics to Elasticsearch. Most settings from the -# Elasticsearch output are accepted here as well. -# Note that the settings should point to your Elasticsearch *monitoring* cluster. -# Any setting that is not set is automatically inherited from the Elasticsearch -# output configuration, so if you have the Elasticsearch output configured such -# that it is pointing to your Elasticsearch monitoring cluster, you can simply -# uncomment the following line. -#monitoring.elasticsearch: - - # Array of hosts to connect to. - # Scheme and port can be left out and will be set to the default (http and 9200) - # In case you specify an additional path, the scheme is required: http://localhost:9200/path - # IPv6 addresses should always be defined as: https://[2001:db8::1]:9200 - #hosts: ["localhost:9200"] - - # Set gzip compression level. - #compression_level: 0 - - # Protocol - either `http` (default) or `https`. - #protocol: "https" - - # Authentication credentials - either API key or username/password. - #api_key: "id:api_key" - #username: "beats_system" - #password: "changeme" - - # Dictionary of HTTP parameters to pass within the URL with index operations. - #parameters: - #param1: value1 - #param2: value2 - - # Custom HTTP headers to add to each request - #headers: - # X-My-Header: Contents of the header - - # Proxy server url - #proxy_url: http://proxy:3128 - - # The number of times a particular Elasticsearch index operation is attempted. If - # the indexing operation doesn't succeed after this many retries, the events are - # dropped. The default is 3. - #max_retries: 3 - - # The maximum number of events to bulk in a single Elasticsearch bulk API index request. - # The default is 50. - #bulk_max_size: 50 - - # The number of seconds to wait before trying to reconnect to Elasticsearch - # after a network error. After waiting backoff.init seconds, the Beat - # tries to reconnect. If the attempt fails, the backoff timer is increased - # exponentially up to backoff.max. After a successful connection, the backoff - # timer is reset. The default is 1s. - #backoff.init: 1s - - # The maximum number of seconds to wait before attempting to connect to - # Elasticsearch after a network error. The default is 60s. - #backoff.max: 60s - - # Configure HTTP request timeout before failing a request to Elasticsearch. - #timeout: 90 - - # Use SSL settings for HTTPS. - #ssl.enabled: true - - # Controls the verification of certificates. Valid values are: - # * full, which verifies that the provided certificate is signed by a trusted - # authority (CA) and also verifies that the server's hostname (or IP address) - # matches the names identified within the certificate. - # * strict, which verifies that the provided certificate is signed by a trusted - # authority (CA) and also verifies that the server's hostname (or IP address) - # matches the names identified within the certificate. If the Subject Alternative - # Name is empty, it returns an error. - # * certificate, which verifies that the provided certificate is signed by a - # trusted authority (CA), but does not perform any hostname verification. - # * none, which performs no verification of the server's certificate. This - # mode disables many of the security benefits of SSL/TLS and should only be used - # after very careful consideration. It is primarily intended as a temporary - # diagnostic mechanism when attempting to resolve TLS errors; its use in - # production environments is strongly discouraged. - # The default value is full. - #ssl.verification_mode: full - - # List of supported/valid TLS versions. By default all TLS versions from 1.1 - # up to 1.3 are enabled. - #ssl.supported_protocols: [TLSv1.1, TLSv1.2, TLSv1.3] - - # List of root certificates for HTTPS server verifications - #ssl.certificate_authorities: ["/etc/pki/root/ca.pem"] - - # Certificate for SSL client authentication - #ssl.certificate: "/etc/pki/client/cert.pem" - - # Client certificate key - #ssl.key: "/etc/pki/client/cert.key" - - # Optional passphrase for decrypting the certificate key. - #ssl.key_passphrase: '' - - # Configure cipher suites to be used for SSL connections - #ssl.cipher_suites: [] - - # Configure curve types for ECDHE-based cipher suites - #ssl.curve_types: [] - - # Configure what types of renegotiation are supported. Valid options are - # never, once, and freely. Default is never. - #ssl.renegotiation: never - - # Configure a pin that can be used to do extra validation of the verified certificate chain, - # this allow you to ensure that a specific certificate is used to validate the chain of trust. - # - # The pin is a base64 encoded string of the SHA-256 fingerprint. - #ssl.ca_sha256: "" - - # A root CA HEX encoded fingerprint. During the SSL handshake if the - # fingerprint matches the root CA certificate, it will be added to - # the provided list of root CAs (`certificate_authorities`), if the - # list is empty or not defined, the matching certificate will be the - # only one in the list. Then the normal SSL validation happens. - #ssl.ca_trusted_fingerprint: "" - - # Enable Kerberos support. Kerberos is automatically enabled if any Kerberos setting is set. - #kerberos.enabled: true - - # Authentication type to use with Kerberos. Available options: keytab, password. - #kerberos.auth_type: password - - # Path to the keytab file. It is used when auth_type is set to keytab. - #kerberos.keytab: /etc/elastic.keytab - - # Path to the Kerberos configuration. - #kerberos.config_path: /etc/krb5.conf - - # Name of the Kerberos user. - #kerberos.username: elastic - - # Password of the Kerberos user. It is used when auth_type is set to password. - #kerberos.password: changeme - - # Kerberos realm. - #kerberos.realm: ELASTIC - - #metrics.period: 10s - #state.period: 1m - -# The `monitoring.cloud.id` setting overwrites the `monitoring.elasticsearch.hosts` -# setting. You can find the value for this setting in the Elastic Cloud web UI. -#monitoring.cloud.id: - -# The `monitoring.cloud.auth` setting overwrites the `monitoring.elasticsearch.username` -# and `monitoring.elasticsearch.password` settings. The format is `:`. -#monitoring.cloud.auth: - -# =============================== HTTP Endpoint ================================ - -# Each beat can expose internal metrics through an HTTP endpoint. For security -# reasons the endpoint is disabled by default. This feature is currently experimental. -# Stats can be accessed through http://localhost:5066/stats. For pretty JSON output -# append ?pretty to the URL. - -# Defines if the HTTP endpoint is enabled. -#http.enabled: false - -# The HTTP endpoint will bind to this hostname, IP address, unix socket, or named pipe. -# When using IP addresses, it is recommended to only use localhost. -#http.host: localhost - -# Port on which the HTTP endpoint will bind. Default is 5066. -#http.port: 5066 - -# Define which user should be owning the named pipe. -#http.named_pipe.user: - -# Define which permissions should be applied to the named pipe, use the Security -# Descriptor Definition Language (SDDL) to define the permission. This option cannot be used with -# `http.user`. -#http.named_pipe.security_descriptor: - -# Defines if the HTTP pprof endpoints are enabled. -# It is recommended that this is only enabled on localhost as these endpoints may leak data. -#http.pprof.enabled: false - -# Controls the fraction of goroutine blocking events that are reported in the -# blocking profile. -#http.pprof.block_profile_rate: 0 - -# Controls the fraction of memory allocations that are recorded and reported in -# the memory profile. -#http.pprof.mem_profile_rate: 524288 - -# Controls the fraction of mutex contention events that are reported in the -# mutex profile. -#http.pprof.mutex_profile_rate: 0 - -# ============================== Process Security ============================== - -# Enable or disable seccomp system call filtering on Linux. Default is enabled. -#seccomp.enabled: true - -# ============================== Instrumentation =============================== - -# Instrumentation support for the functionbeat. -#instrumentation: - # Set to true to enable instrumentation of functionbeat. - #enabled: false - - # Environment in which functionbeat is running on (eg: staging, production, etc.) - #environment: "" - - # APM Server hosts to report instrumentation results to. - #hosts: - # - http://localhost:8200 - - # API Key for the APM Server(s). - # If api_key is set then secret_token will be ignored. - #api_key: - - # Secret token for the APM Server(s). - #secret_token: - - # Enable profiling of the server, recording profile samples as events. - # - # This feature is experimental. - #profiling: - #cpu: - # Set to true to enable CPU profiling. - #enabled: false - #interval: 60s - #duration: 10s - #heap: - # Set to true to enable heap profiling. - #enabled: false - #interval: 60s - -# ================================= Migration ================================== - -# This allows to enable 6.7 migration aliases -#migration.6_to_7.enabled: false - -# =============================== Feature Flags ================================ - -# Enable and configure feature flags. -#features: -# fqdn: -# enabled: true - diff --git a/x-pack/functionbeat/functionbeat.yml b/x-pack/functionbeat/functionbeat.yml deleted file mode 100644 index 9a2627ca44f..00000000000 --- a/x-pack/functionbeat/functionbeat.yml +++ /dev/null @@ -1,416 +0,0 @@ -###################### Functionbeat Configuration Example ####################### - -# This file is an example configuration file highlighting only the most common -# options. The functionbeat.reference.yml file from the same directory contains all the -# supported options with more comments. You can use it as a reference. -# -# You can find the full configuration reference here: -# https://www.elastic.co/guide/en/beats/functionbeat/index.html -# - -# ================================== Provider ================================== -# Configure functions to run on AWS Lambda, currently, we assume that the credentials -# are present in the environment to correctly create the function when using the CLI. -# -# Configure which S3 endpoint should we use. -functionbeat.provider.aws.endpoint: "s3.amazonaws.com" -# Configure which S3 bucket we should upload the lambda artifact. -functionbeat.provider.aws.deploy_bucket: "functionbeat-deploy" - -functionbeat.provider.aws.functions: - # Define the list of functions available, each function is required to have a unique name. - # Create a function that accepts events coming from cloudwatchlogs. - - name: cloudwatch - enabled: false - type: cloudwatch_logs - - # Description of the method to help identify them when you run multiple functions. - description: "lambda function for cloudwatch logs" - - # Concurrency, is the reserved number of instances for that function. - # Default is 5. - # - # Note: There is a hard limit of 1000 functions of any kind per account. - #concurrency: 5 - - # The maximum memory allocated for this function, the configured size must be a factor of 64. - # There is a hard limit of 3008MiB for each function. Default is 128MiB. - #memory_size: 128MiB - - # Dead letter queue configuration, this must be set to an ARN pointing to an SQS queue. - #dead_letter_config.target_arn: - - # Execution role of the function. - #role: arn:aws:iam::123456789012:role/MyFunction - - # Connect to private resources in an Amazon VPC. - #virtual_private_cloud: - # security_group_ids: [] - # subnet_ids: [] - - # Optional fields that you can specify to add additional information to the - # output. Fields can be scalar values, arrays, dictionaries, or any nested - # combination of these. - #fields: - # env: staging - - # List of cloudwatch log groups registered to that function. - triggers: - - log_group_name: /aws/lambda/functionbeat-cloudwatch_logs - filter_pattern: mylog_ - - # Define custom processors for this function. - #processors: - # - dissect: - # tokenizer: "%{key1} %{key2}" - - # Create a function that accepts events from SQS queues. - - name: sqs - enabled: false - type: sqs - - # Description of the method to help identify them when you run multiple functions. - description: "lambda function for SQS events" - - # Concurrency, is the reserved number of instances for that function. - # Default is 5. - # - # Note: There is a hard limit of 1000 functions of any kind per account. - #concurrency: 5 - - # The maximum memory allocated for this function, the configured size must be a factor of 64. - # There is a hard limit of 3008MiB for each function. Default is 128MiB. - #memory_size: 128MiB - - # Dead letter queue configuration, this must be set to an ARN pointing to an SQS queue. - #dead_letter_config.target_arn: - - # Execution role of the function. - #role: arn:aws:iam::123456789012:role/MyFunction - - # Connect to private resources in an Amazon VPC. - #virtual_private_cloud: - # security_group_ids: [] - # subnet_ids: [] - - # Optional fields that you can specify to add additional information to the - # output. Fields can be scalar values, arrays, dictionaries, or any nested - # combination of these. - #fields: - # env: staging - - # List of SQS queues. - triggers: - # Arn for the SQS queue. - - event_source_arn: arn:aws:sqs:us-east-1:xxxxx:myevents - - # Define custom processors for this function. - #processors: - # - decode_json_fields: - # fields: ["message"] - # process_array: false - # max_depth: 1 - # target: "" - # overwrite_keys: false - # - - # Create a function that accepts events from Kinesis streams. - - name: kinesis - enabled: false - type: kinesis - - # Description of the method to help identify them when you run multiple functions. - description: "lambda function for Kinesis events" - - # Concurrency, is the reserved number of instances for that function. - # Default is 5. - # - # Note: There is a hard limit of 1000 functions of any kind per account. - #concurrency: 5 - - # The maximum memory allocated for this function, the configured size must be a factor of 64. - # There is a hard limit of 3008MiB for each function. Default is 128MiB. - #memory_size: 128MiB - - # Dead letter queue configuration, this must be set to an ARN pointing to an SQS queue. - #dead_letter_config.target_arn: - - # Execution role of the function. - #role: arn:aws:iam::123456789012:role/MyFunction - - # Connect to private resources in an Amazon VPC. - #virtual_private_cloud: - # security_group_ids: [] - # subnet_ids: [] - - # Optional fields that you can specify to add additional information to the - # output. Fields can be scalar values, arrays, dictionaries, or any nested - # combination of these. - #fields: - # env: staging - - # Define custom processors for this function. - #processors: - # This example extracts the raw data from events. - # - decode_base64_field: - # field: - # from: message - # to: message - # - decompress_gzip_field: - # field: - # from: message - # to: message - # - decode_json_fields: - # fields: ["message"] - # process_array: false - # max_depth: 1 - # target: "" - # overwrite_keys: false - - # List of Kinesis streams. - triggers: - # Arn for the Kinesis stream. - - event_source_arn: arn:aws:kinesis:us-east-1:xxxxx:myevents - - # batch_size is the number of events read in a batch. - # Default is 10. - #batch_size: 100 - - # Starting position is where to start reading events from the Kinesis stream. - # Default is trim_horizon. - #starting_position: "trim_horizon" - - # parallelization_factor is the number of batches to process from each shard concurrently. - # Default is 1. - #parallelization_factor: 1 - - # Create a function that accepts Cloudwatch logs from Kinesis streams. - - name: cloudwatch-logs-kinesis - enabled: false - type: cloudwatch_logs_kinesis - - # Description of the method to help identify them when you run multiple functions. - description: "lambda function for Cloudwatch logs in Kinesis events" - - # Set base64_encoded if your data is base64 encoded. - #base64_encoded: false - - # Set compressed if your data is compressed with gzip. - #compressed: true - - # Concurrency, is the reserved number of instances for that function. - # Default is 5. - # - # Note: There is a hard limit of 1000 functions of any kind per account. - #concurrency: 5 - - # The maximum memory allocated for this function, the configured size must be a factor of 64. - # There is a hard limit of 3008MiB for each function. Default is 128MiB. - #memory_size: 128MiB - - # Dead letter queue configuration, this must be set to an ARN pointing to an SQS queue. - #dead_letter_config.target_arn: - - # Execution role of the function. - #role: arn:aws:iam::123456789012:role/MyFunction - - # Connect to private resources in an Amazon VPC. - #virtual_private_cloud: - # security_group_ids: [] - # subnet_ids: [] - - # Optional fields that you can specify to add additional information to the - # output. Fields can be scalar values, arrays, dictionaries, or any nested - # combination of these. - #fields: - # env: staging - - # Define custom processors for this function. - #processors: - # - decode_json_fields: - # fields: ["message"] - # process_array: false - # max_depth: 1 - # target: "" - # overwrite_keys: false - - # List of Kinesis streams. - triggers: - # Arn for the Kinesis stream. - - event_source_arn: arn:aws:kinesis:us-east-1:xxxxx:myevents - - # batch_size is the number of events read in a batch. - # Default is 10. - #batch_size: 100 - - # Starting position is where to start reading events from the Kinesis stream. - # Default is trim_horizon. - #starting_position: "trim_horizon" - - # parallelization_factor is the number of batches to process from each shard concurrently. - # Default is 1. - #parallelization_factor: 1 - - -# ================================== General =================================== - -# The name of the shipper that publishes the network data. It can be used to group -# all the transactions sent by a single shipper in the web interface. -#name: - -# The tags of the shipper are included in their field with each -# transaction published. -#tags: ["service-X", "web-tier"] - -# Optional fields that you can specify to add additional information to the -# output. -#fields: -# env: staging - -# ================================= Dashboards ================================= -# These settings control loading the sample dashboards to the Kibana index. Loading -# the dashboards is disabled by default and can be enabled either by setting the -# options here or by using the `setup` command. -#setup.dashboards.enabled: false - -# The URL from where to download the dashboard archive. By default, this URL -# has a value that is computed based on the Beat name and version. For released -# versions, this URL points to the dashboard archive on the artifacts.elastic.co -# website. -#setup.dashboards.url: - -# =================================== Kibana =================================== - -# Starting with Beats version 6.0.0, the dashboards are loaded via the Kibana API. -# This requires a Kibana endpoint configuration. -setup.kibana: - - # Kibana Host - # Scheme and port can be left out and will be set to the default (http and 5601) - # In case you specify and additional path, the scheme is required: http://localhost:5601/path - # IPv6 addresses should always be defined as: https://[2001:db8::1]:5601 - #host: "localhost:5601" - - # Kibana Space ID - # ID of the Kibana Space into which the dashboards should be loaded. By default, - # the Default Space will be used. - #space.id: - -# =============================== Elastic Cloud ================================ - -# These settings simplify using Functionbeat with the Elastic Cloud (https://cloud.elastic.co/). - -# The cloud.id setting overwrites the `output.elasticsearch.hosts` and -# `setup.kibana.host` options. -# You can find the `cloud.id` in the Elastic Cloud web UI. -#cloud.id: - -# The cloud.auth setting overwrites the `output.elasticsearch.username` and -# `output.elasticsearch.password` settings. The format is `:`. -#cloud.auth: - -# ================================== Outputs =================================== - -# Configure what output to use when sending the data collected by the beat. - -# ---------------------------- Elasticsearch Output ---------------------------- -output.elasticsearch: - # Array of hosts to connect to. - hosts: ["localhost:9200"] - - # Performance preset - one of "balanced", "throughput", "scale", - # "latency", or "custom". - preset: balanced - - # Protocol - either `http` (default) or `https`. - #protocol: "https" - - # Authentication credentials - either API key or username/password. - #api_key: "id:api_key" - #username: "elastic" - #password: "changeme" - -# ------------------------------ Logstash Output ------------------------------- -#output.logstash: - # The Logstash hosts - #hosts: ["localhost:5044"] - - # Optional SSL. By default is off. - # List of root certificates for HTTPS server verifications - #ssl.certificate_authorities: ["/etc/pki/root/ca.pem"] - - # Certificate for SSL client authentication - #ssl.certificate: "/etc/pki/client/cert.pem" - - # Client Certificate Key - #ssl.key: "/etc/pki/client/cert.key" - -# ================================= Processors ================================= - -# Configure processors to enhance or manipulate events generated by the beat. - -processors: - - add_host_metadata: ~ - - add_cloud_metadata: ~ - - -# ================================== Logging =================================== - -# Sets log level. The default log level is info. -# Available log levels are: error, warning, info, debug -#logging.level: debug - -# At debug level, you can selectively enable logging only for some components. -# To enable all selectors, use ["*"]. Examples of other selectors are "beat", -# "publisher", "service". -#logging.selectors: ["*"] - -# ============================= X-Pack Monitoring ============================== -# Functionbeat can export internal metrics to a central Elasticsearch monitoring -# cluster. This requires xpack monitoring to be enabled in Elasticsearch. The -# reporting is disabled by default. - -# Set to true to enable the monitoring reporter. -#monitoring.enabled: false - -# Sets the UUID of the Elasticsearch cluster under which monitoring data for this -# Functionbeat instance will appear in the Stack Monitoring UI. If output.elasticsearch -# is enabled, the UUID is derived from the Elasticsearch cluster referenced by output.elasticsearch. -#monitoring.cluster_uuid: - -# Uncomment to send the metrics to Elasticsearch. Most settings from the -# Elasticsearch outputs are accepted here as well. -# Note that the settings should point to your Elasticsearch *monitoring* cluster. -# Any setting that is not set is automatically inherited from the Elasticsearch -# output configuration, so if you have the Elasticsearch output configured such -# that it is pointing to your Elasticsearch monitoring cluster, you can simply -# uncomment the following line. -#monitoring.elasticsearch: - -# ============================== Instrumentation =============================== - -# Instrumentation support for the functionbeat. -#instrumentation: - # Set to true to enable instrumentation of functionbeat. - #enabled: false - - # Environment in which functionbeat is running on (eg: staging, production, etc.) - #environment: "" - - # APM Server hosts to report instrumentation results to. - #hosts: - # - http://localhost:8200 - - # API Key for the APM Server(s). - # If api_key is set then secret_token will be ignored. - #api_key: - - # Secret token for the APM Server(s). - #secret_token: - - -# ================================= Migration ================================== - -# This allows to enable 6.7 migration aliases -#migration.6_to_7.enabled: true - diff --git a/x-pack/functionbeat/include/feature.go b/x-pack/functionbeat/include/feature.go deleted file mode 100644 index b37796cfd77..00000000000 --- a/x-pack/functionbeat/include/feature.go +++ /dev/null @@ -1,16 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package include - -import ( - "github.com/elastic/beats/v7/libbeat/feature" - "github.com/elastic/beats/v7/x-pack/functionbeat/manager/aws" - "github.com/elastic/beats/v7/x-pack/functionbeat/provider/local/local" -) - -func init() { - feature.MustRegister(aws.Features...) - feature.MustRegister(local.Features...) -} diff --git a/x-pack/functionbeat/include/fields.go b/x-pack/functionbeat/include/fields.go deleted file mode 100644 index b58f331ad47..00000000000 --- a/x-pack/functionbeat/include/fields.go +++ /dev/null @@ -1,23 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -// Code generated by beats/dev-tools/cmd/asset/asset.go - DO NOT EDIT. - -package include - -import ( - "github.com/elastic/beats/v7/libbeat/asset" -) - -func init() { - if err := asset.SetFields("functionbeat", "fields.yml", asset.BeatFieldsPri, AssetFieldsYml); err != nil { - panic(err) - } -} - -// AssetFieldsYml returns asset data. -// This is the base64 encoded zlib format compressed contents of fields.yml. -func AssetFieldsYml() string { - return "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" -} diff --git a/x-pack/functionbeat/magefile.go b/x-pack/functionbeat/magefile.go deleted file mode 100644 index 5df39f8c3c8..00000000000 --- a/x-pack/functionbeat/magefile.go +++ /dev/null @@ -1,234 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -//go:build mage - -package main - -import ( - "fmt" - "os" - "path/filepath" - "runtime" - "time" - - "github.com/magefile/mage/mg" - - devtools "github.com/elastic/beats/v7/dev-tools/mage" - "github.com/elastic/beats/v7/dev-tools/mage/target/build" - functionbeat "github.com/elastic/beats/v7/x-pack/functionbeat/scripts/mage" - - // mage:import - _ "github.com/elastic/beats/v7/dev-tools/mage/target/common" - // mage:import - _ "github.com/elastic/beats/v7/dev-tools/mage/target/pkg" - // mage:import - _ "github.com/elastic/beats/v7/dev-tools/mage/target/unittest" - // mage:import - _ "github.com/elastic/beats/v7/dev-tools/mage/target/integtest/notests" - // mage:import - _ "github.com/elastic/beats/v7/dev-tools/mage/target/test" -) - -func init() { - devtools.BeatDescription = "Functionbeat is a beat implementation for a serverless architecture." - devtools.BeatLicense = "Elastic License" -} - -// Build builds the Beat binary and functions by provider. -func Build() error { - params := devtools.DefaultBuildArgs() - - // Building functionbeat manager - err := devtools.Build(params) - if err != nil { - return err - } - - // Getting selected cloud providers - selectedProviders, err := functionbeat.SelectedProviders() - if err != nil { - return err - } - - // Building functions to deploy - for _, provider := range selectedProviders { - if !provider.Buildable { - continue - } - - inputFiles := filepath.Join("provider", provider.Name, "main.go") - params.InputFiles = []string{inputFiles} - params.Name = devtools.BeatName + "-" + provider.Name - params.OutputDir = filepath.Join("provider", provider.Name) - params.CGO = false - params.Env = make(map[string]string) - if provider.GOOS != "" { - params.Env["GOOS"] = provider.GOOS - } - if provider.GOARCH != "" { - params.Env["GOARCH"] = provider.GOARCH - } - err := devtools.Build(params) - if err != nil { - return err - } - } - return nil -} - -// GolangCrossBuild build the Beat binary inside of the golang-builder. -// Do not use directly, use crossBuild instead. -func GolangCrossBuild() error { - return devtools.GolangCrossBuild(devtools.DefaultGolangCrossBuildArgs()) -} - -// BuildGoDaemon builds the go-daemon binary (use crossBuildGoDaemon). -func BuildGoDaemon() error { - return devtools.BuildGoDaemon() -} - -// CrossBuild cross-builds the beat for all target platforms. -func CrossBuild() error { - - // Building functionbeat manager - err := devtools.CrossBuild() - if err != nil { - return err - } - - // Getting selected cloud providers - selectedProviders, err := functionbeat.SelectedProviders() - if err != nil { - return err - } - - // Building functions to deploy - for _, provider := range selectedProviders { - if !provider.Buildable { - continue - } - - if runtime.GOARCH != "amd64" { - fmt.Println("Crossbuilding functions only works on amd64 architecture.") - return nil - } - - err := devtools.CrossBuild(devtools.AddPlatforms("linux/amd64"), devtools.InDir("x-pack", "functionbeat", "provider", provider.Name)) - if err != nil { - return err - } - } - return nil -} - -// CrossBuildGoDaemon cross-builds the go-daemon binary using Docker. -func CrossBuildGoDaemon() error { - return devtools.CrossBuildGoDaemon() -} - -// Update is an alias for update:all. This is a workaround for -// https://github.com/magefile/mage/issues/217. -func Update() { mg.Deps(functionbeat.Update.All) } - -// Fields is an alias for update:fields. This is a workaround for -// https://github.com/magefile/mage/issues/217. -func Fields() { mg.Deps(functionbeat.Update.Fields) } - -// Config is an alias for update:config. This is a workaround for -// https://github.com/magefile/mage/issues/217. -func Config() { mg.Deps(functionbeat.Update.Config) } - -// AssembleDarwinUniversal merges the darwin/amd64 and darwin/arm64 into a single -// universal binary using `lipo`. It assumes the darwin/amd64 and darwin/arm64 -// were built and only performs the merge. -func AssembleDarwinUniversal() error { - return build.AssembleDarwinUniversal() -} - -// Package packages the Beat for distribution. -// Use SNAPSHOT=true to build snapshots. -// Use PLATFORMS to control the target platforms. -func Package() { - start := time.Now() - defer func() { fmt.Println("package ran for", time.Since(start)) }() - - devtools.MustUsePackaging("functionbeat", "x-pack/functionbeat/dev-tools/packaging/packages.yml") - - mg.Deps(Update) - mg.Deps(CrossBuild, CrossBuildGoDaemon) - mg.SerialDeps(devtools.Package, TestPackages) -} - -// Package packages the Beat for IronBank distribution. -// -// Use SNAPSHOT=true to build snapshots. -func Ironbank() error { - fmt.Println(">> Ironbank: this module is not subscribed to the IronBank releases.") - return nil -} - -// TestPackages tests the generated packages (i.e. file modes, owners, groups). -func TestPackages() error { - return devtools.TestPackages() -} - -// BuildPkgForFunctions creates a folder named pkg and adds functions to it. -// This makes testing the manager more comfortable. -func BuildPkgForFunctions() error { - mg.Deps(Update, Build) - - err := os.RemoveAll("pkg") - - filesToCopy := map[string]string{ - filepath.Join("provider", "aws", "functionbeat-aws"): filepath.Join("pkg", "functionbeat-aws"), - } - for src, dest := range filesToCopy { - c := &devtools.CopyTask{ - Source: src, - Dest: dest, - } - err = c.Execute() - if err != nil { - return err - } - } - return nil -} - -// BuildSystemTestBinary build a binary for testing that is instrumented for -// testing and measuring code coverage. The binary is only instrumented for -// coverage when TEST_COVERAGE=true (default is false). -func BuildSystemTestBinary() error { - err := devtools.BuildSystemTestBinary() - if err != nil { - return err - } - - params := devtools.DefaultTestBinaryArgs() - - // Getting selected cloud providers - selectedProviders, err := functionbeat.SelectedProviders() - if err != nil { - return err - } - - for _, provider := range selectedProviders { - if !provider.Buildable { - continue - } - - params.Name = filepath.Join("provider", provider.Name, devtools.BeatName+"-"+provider.Name) - inputFiles := make([]string, 0) - for _, inputFileName := range []string{"main.go", "main_test.go"} { - inputFiles = append(inputFiles, filepath.Join("provider", provider.Name, inputFileName)) - } - params.InputFiles = inputFiles - err := devtools.BuildSystemTestGoBinary(params) - if err != nil { - return err - } - } - return nil -} diff --git a/x-pack/functionbeat/main.go b/x-pack/functionbeat/main.go deleted file mode 100644 index 47c4c10ad4f..00000000000 --- a/x-pack/functionbeat/main.go +++ /dev/null @@ -1,19 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package main - -import ( - "os" - _ "time/tzdata" // for timezone handling - - _ "github.com/elastic/beats/v7/x-pack/functionbeat/include" // imports features - "github.com/elastic/beats/v7/x-pack/functionbeat/manager/cmd" -) - -func main() { - if err := cmd.RootCmd.Execute(); err != nil { - os.Exit(1) - } -} diff --git a/x-pack/functionbeat/main_test.go b/x-pack/functionbeat/main_test.go deleted file mode 100644 index 1c21f88e289..00000000000 --- a/x-pack/functionbeat/main_test.go +++ /dev/null @@ -1,40 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package main - -// This file is mandatory as otherwise the functionbeat.test binary is not generated correctly. - -import ( - "flag" - "testing" - - "github.com/elastic/beats/v7/libbeat/cfgfile" - "github.com/elastic/beats/v7/libbeat/tests/system/template" - "github.com/elastic/beats/v7/x-pack/functionbeat/manager/cmd" -) - -var systemTest *bool - -func init() { - testing.Init() - systemTest = flag.Bool("systemTest", false, "Set to true when running system tests") - - cmd.RootCmd.PersistentFlags().AddGoFlag(flag.CommandLine.Lookup("systemTest")) - cfgfile.AddAllowedBackwardsCompatibleFlag("systemTest") - cmd.RootCmd.PersistentFlags().AddGoFlag(flag.CommandLine.Lookup("test.coverprofile")) - cfgfile.AddAllowedBackwardsCompatibleFlag("test.coverprofile") -} - -// Test started when the test binary is started. Only calls main. -func TestSystem(t *testing.T) { - cfgfile.ConvertFlagsForBackwardsCompatibility() - if *systemTest { - main() - } -} - -func TestTemplate(t *testing.T) { - template.TestTemplate(t, cmd.Name, true) -} diff --git a/x-pack/functionbeat/make.bat b/x-pack/functionbeat/make.bat deleted file mode 100644 index 9fe6b2b801e..00000000000 --- a/x-pack/functionbeat/make.bat +++ /dev/null @@ -1,11 +0,0 @@ -@echo off - -REM Windows wrapper for Mage (https://magefile.org/) that installs it -REM to %GOPATH%\bin from the Beats vendor directory. -REM -REM After running this once you may invoke mage.exe directly. - -WHERE mage -IF %ERRORLEVEL% NEQ 0 go install github.com/ph/functionbeat/vendor/github.com/magefile/mage - -mage %* diff --git a/x-pack/functionbeat/manager/aws/aws.go b/x-pack/functionbeat/manager/aws/aws.go deleted file mode 100644 index a8f2f5a5ad1..00000000000 --- a/x-pack/functionbeat/manager/aws/aws.go +++ /dev/null @@ -1,33 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package aws - -import ( - "github.com/elastic/beats/v7/libbeat/feature" - "github.com/elastic/beats/v7/x-pack/functionbeat/function/provider" - "github.com/elastic/beats/v7/x-pack/functionbeat/provider/aws/aws" -) - -// Features exposes the trigger supported by the AWS provider. -var Features = provider.Builder( - "aws", - provider.NewDefaultProvider("aws", NewCLI, NewTemplateBuilder), - feature.MakeDetails("AWS Lambda", "listen to events on AWS lambda", feature.Stable), -).AddFunction("cloudwatch_logs", - aws.NewCloudwatchLogs, - aws.CloudwatchLogsDetails(), -).AddFunction("api_gateway_proxy", - aws.NewAPIGatewayProxy, - aws.APIGatewayProxyDetails(), -).AddFunction("kinesis", - aws.NewKinesis, - aws.KinesisDetails(), -).AddFunction("sqs", - aws.NewSQS, - aws.SQSDetails(), -).AddFunction("cloudwatch_logs_kinesis", - aws.NewCloudwatchKinesis, - aws.CloudwatchKinesisDetails(), -).Features() diff --git a/x-pack/functionbeat/manager/aws/cli_manager.go b/x-pack/functionbeat/manager/aws/cli_manager.go deleted file mode 100644 index 3bdb5ffa1ad..00000000000 --- a/x-pack/functionbeat/manager/aws/cli_manager.go +++ /dev/null @@ -1,240 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package aws - -import ( - "context" - "fmt" - "os" - "strings" - - "github.com/aws/aws-sdk-go-v2/aws" - cf "github.com/aws/aws-sdk-go-v2/service/cloudformation" - "github.com/awslabs/goformation/v7/cloudformation" - "github.com/awslabs/goformation/v7/cloudformation/iam" - "github.com/awslabs/goformation/v7/cloudformation/lambda" - - "github.com/elastic/beats/v7/x-pack/functionbeat/function/provider" - "github.com/elastic/beats/v7/x-pack/functionbeat/manager/core" - "github.com/elastic/beats/v7/x-pack/functionbeat/manager/executor" - fnaws "github.com/elastic/beats/v7/x-pack/functionbeat/provider/aws/aws" - awscommon "github.com/elastic/beats/v7/x-pack/libbeat/common/aws" - conf "github.com/elastic/elastic-agent-libs/config" - "github.com/elastic/elastic-agent-libs/logp" -) - -const ( - // AWS lambda currently support go 1.x as a runtime. - runtime = "go1.x" - handlerName = "functionbeat-aws" -) - -// AWSLambdaFunction add 'dependsOn' as a serializable parameters, goformation doesn't currently -// serialize this field. -type AWSLambdaFunction struct { - *lambda.Function - DependsOn []string -} - -type installer interface { - Policies() []iam.Role_Policy - Template() *cloudformation.Template - LambdaConfig() *fnaws.LambdaConfig -} - -// CLIManager interacts with the AWS Lambda API to deploy, update or remove a function. -// It will take care of creating the main lambda function and ask for each function type for the -// operation that need to be executed to connect the lambda to the triggers. -type CLIManager struct { - templateBuilder *defaultTemplateBuilder - awsCfg aws.Config - log *logp.Logger - config *fnaws.Config -} - -// stackName cloudformation stack are unique per function. -func (c *CLIManager) stackName(name string) string { - return "fnb-" + name + "-stack" -} - -func (c *CLIManager) deployTemplate(update bool, name string) error { - templateData, err := c.templateBuilder.execute(name) - if err != nil { - return err - } - - c.log.Debugf("Using cloudformation template:\n%s", templateData.json) - - _, err = c.awsCfg.Credentials.Retrieve(context.Background()) - if err != nil { - return fmt.Errorf("failed to retrieve aws credentials, please check AWS credential in config: %w", err) - } - - svcCF := cf.NewFromConfig(c.awsCfg) - - executer := executor.NewExecutor(c.log) - _ = executer.Add(newOpEnsureBucket(c.log, c.awsCfg, c.bucket())) - _ = executer.Add(newOpUploadToBucket( - c.log, - c.awsCfg, - c.bucket(), - templateData.codeKey, - templateData.zip.content, - )) - _ = executer.Add(newOpUploadToBucket( - c.log, - c.awsCfg, - c.bucket(), - templateData.key, - templateData.json, - )) - if update { - _ = executer.Add(newOpUpdateCloudFormation( - c.log, - svcCF, - templateData.url, - c.stackName(name), - )) - } else { - _ = executer.Add(newOpCreateCloudFormation( - c.log, - svcCF, - templateData.url, - c.stackName(name), - )) - } - - _ = executer.Add(newOpWaitCloudFormation(c.log, cf.NewFromConfig(c.awsCfg))) - _ = executer.Add(newOpDeleteFileBucket(c.log, c.awsCfg, c.bucket(), templateData.codeKey)) - - ctx := newStackContext() - if err := executer.Execute(ctx); err != nil { - if rollbackErr := executer.Rollback(ctx); rollbackErr != nil { - return fmt.Errorf("could not rollback, error: %s, %w", rollbackErr.Error(), err) - } - return err - } - return nil -} - -// Deploy uploads the function to AWS. -func (c *CLIManager) Deploy(name string) error { - c.log.Debugf("Deploying function: %s", name) - defer c.log.Debugf("Deploy finish for function '%s'", name) - - if err := c.deployTemplate(false, name); err != nil { - return err - } - c.log.Debugf("Successfully created function '%s'", name) - return nil -} - -// Update updates lambda using cloudformation. -func (c *CLIManager) Update(name string) error { - c.log.Debugf("Starting updating function '%s'", name) - defer c.log.Debugf("Update complete for function '%s'", name) - - if err := c.deployTemplate(true, name); err != nil { - return err - } - - c.log.Debugf("Successfully updated function: '%s'", name) - return nil -} - -// Remove removes a stack and unregister any resources created. -func (c *CLIManager) Remove(name string) error { - c.log.Debugf("Removing function: %s", name) - defer c.log.Debugf("Removal of function '%s' complete", name) - - _, err := c.awsCfg.Credentials.Retrieve(context.Background()) - if err != nil { - return fmt.Errorf("failed to retrieve aws credentials, please check AWS credential in config: %w", err) - } - - svc := cf.NewFromConfig(c.awsCfg) - executer := executor.NewExecutor(c.log) - _ = executer.Add(newOpDeleteCloudFormation(c.log, svc, c.stackName(name))) - _ = executer.Add(newWaitDeleteCloudFormation(c.log, c.awsCfg)) - - ctx := newStackContext() - if err := executer.Execute(ctx); err != nil { - if rollbackErr := executer.Rollback(ctx); rollbackErr != nil { - return fmt.Errorf("could not rollback, error: %s, %w", rollbackErr.Error(), err) - } - return err - } - return nil -} - -// Export prints the exported function data. -func (c *CLIManager) Export(name string) error { - tmpl, err := c.templateBuilder.RawTemplate(name) - if err != nil { - return err - } - - fmt.Println(tmpl) //nolint:forbidigo // standalone tool - - return nil -} - -// Package packages functions for AWS. -func (c *CLIManager) Package(outputPattern string) error { - resource := zipResources() - content, err := core.MakeZip(packageUncompressedLimit, packageCompressedLimit, resource) - if err != nil { - return err - } - - output := strings.ReplaceAll(outputPattern, "{{.Provider}}", "aws") - err = os.WriteFile(output, content, 0644) - if err != nil { - return err - } - - _, _ = fmt.Fprintf(os.Stderr, "Generated package for provider aws at: %s\n", output) - return nil -} - -func (c *CLIManager) bucket() string { - return string(c.config.DeployBucket) -} - -// NewCLI returns the interface to manage function on Amazon lambda. -func NewCLI( - log *logp.Logger, - cfg *conf.C, - provider provider.Provider, -) (provider.CLIManager, error) { - config := fnaws.DefaultConfig() - if err := cfg.Unpack(config); err != nil { - return nil, err - } - awsCfg, err := awscommon.InitializeAWSConfig(config.Credentials) - if err != nil { - return nil, fmt.Errorf("failed to get aws credentials, please check AWS credential in config: %w", err) - } - if config.Region != "" { - awsCfg.Region = config.Region - } - - builder, err := provider.TemplateBuilder() - if err != nil { - return nil, err - } - - templateBuilder, ok := builder.(*defaultTemplateBuilder) - if !ok { - return nil, fmt.Errorf("not defaultTemplateBuilder") - } - - return &CLIManager{ - config: config, - awsCfg: awsCfg, - log: logp.NewLogger("aws"), - templateBuilder: templateBuilder, - }, nil -} diff --git a/x-pack/functionbeat/manager/aws/cli_manager_test.go b/x-pack/functionbeat/manager/aws/cli_manager_test.go deleted file mode 100644 index 336f979587f..00000000000 --- a/x-pack/functionbeat/manager/aws/cli_manager_test.go +++ /dev/null @@ -1,38 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package aws - -import ( - "testing" - - "github.com/stretchr/testify/assert" - - "github.com/elastic/beats/v7/libbeat/common" -) - -func TestChecksum(t *testing.T) { - t.Run("same bytes content return the same key", func(t *testing.T) { - content, err := common.RandomBytes(100) - if !assert.NoError(t, err) { - return - } - - assert.Equal(t, checksum(content), checksum(content)) - }) - - t.Run("different bytes return a different key", func(t *testing.T) { - content, err := common.RandomBytes(100) - if !assert.NoError(t, err) { - return - } - - other, err := common.RandomBytes(100) - if !assert.NoError(t, err) { - return - } - - assert.NotEqual(t, checksum(content), checksum(other)) - }) -} diff --git a/x-pack/functionbeat/manager/aws/cloudformation_interface.go b/x-pack/functionbeat/manager/aws/cloudformation_interface.go deleted file mode 100644 index 46d03734c95..00000000000 --- a/x-pack/functionbeat/manager/aws/cloudformation_interface.go +++ /dev/null @@ -1,24 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package aws - -import ( - "context" - - "github.com/aws/aws-sdk-go-v2/service/cloudformation" -) - -type deleteStackClient interface { - cloudformation.DescribeStacksAPIClient - DeleteStack(ctx context.Context, params *cloudformation.DeleteStackInput, optFns ...func(*cloudformation.Options)) (*cloudformation.DeleteStackOutput, error) -} - -type createStackClient interface { - CreateStack(ctx context.Context, params *cloudformation.CreateStackInput, optFns ...func(*cloudformation.Options)) (*cloudformation.CreateStackOutput, error) -} - -type updateStackClient interface { - UpdateStack(ctx context.Context, params *cloudformation.UpdateStackInput, optFns ...func(*cloudformation.Options)) (*cloudformation.UpdateStackOutput, error) -} diff --git a/x-pack/functionbeat/manager/aws/event_stack_poller.go b/x-pack/functionbeat/manager/aws/event_stack_poller.go deleted file mode 100644 index 6b3b58ae79f..00000000000 --- a/x-pack/functionbeat/manager/aws/event_stack_poller.go +++ /dev/null @@ -1,157 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package aws - -import ( - "context" - "sync" - "time" - - "github.com/aws/aws-sdk-go-v2/service/cloudformation/types" - - "github.com/aws/aws-sdk-go-v2/service/cloudformation" - - "github.com/elastic/elastic-agent-libs/logp" -) - -// Resource type to look for. -const eventAWSCloudFormationStack = "AWS::CloudFormation::Stack" - -type eventStackHandler interface { - sync(event types.StackEvent) bool - handle(event types.StackEvent) -} - -// eventStackPoller takes a stack id and will report any events coming from it. -// The event stream for a stack will return all the events for a specific existence of a stack, -// it's important to be able to skip some events and only report the meaningful events. -type eventStackPoller struct { - log *logp.Logger - svc cloudformation.DescribeStackEventsAPIClient - stackID *string - periodicCheck time.Duration - handler eventStackHandler - done chan struct{} - wg sync.WaitGroup -} - -func newEventStackPoller( - log *logp.Logger, - svc cloudformation.DescribeStackEventsAPIClient, - stackID *string, - periodicCheck time.Duration, - handler eventStackHandler, -) *eventStackPoller { - return &eventStackPoller{ - log: log, - svc: svc, - stackID: stackID, - periodicCheck: periodicCheck, - handler: handler, - done: make(chan struct{}), - } -} - -func (e *eventStackPoller) Start() { - e.wg.Add(1) - go func() { - defer e.wg.Done() - e.poll() - }() -} - -func (e *eventStackPoller) Stop() { - close(e.done) - e.wg.Wait() -} - -func (e *eventStackPoller) poll() { - var nextToken *string - var foundFirstEvent bool - var alreadyLoggedEvents = make(map[string]struct{}) - for { - input := &cloudformation.DescribeStackEventsInput{ - NextToken: nextToken, - StackName: e.stackID, - } - - // Currently no way to skip items based on time. - // doc: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_DescribeStackEvents.html - resp, err := e.svc.DescribeStackEvents(context.TODO(), input) - if err != nil { - // This is not a fatal error because the check is made out of bound from the current status logic. - // I wanted to keep them separate so it is easier to deal with states and reporting. - e.log.Errorf("Could not retrieve the events for stack, error: %+v", err) - } - - // Events are in reverse order. we need older -> new, but we do not rely on the time but just - // the position in the slice. - for i, j := 0, len(resp.StackEvents)-1; i < j; i, j = i+1, j-1 { - resp.StackEvents[i], resp.StackEvents[j] = resp.StackEvents[j], resp.StackEvents[i] - } - - for _, event := range resp.StackEvents { - // Since we receive all the events from the beginning of the stack we have - // to first position ourself to an event of interest. - if !foundFirstEvent { - if !e.handler.sync(event) { - // keep current event and position to the first meaningful event. - foundFirstEvent = true - } else { - //discard current event. - continue - } - } - - // When the stack is in progress we will receive an empty token, so we have to make another - // call with the current token this mean we probably have already see the events so we have to - // ignore them. I am using ids here instance of time because I think 2 events might have - // the same time. I am assuming this map should stay relatively small. - if _, ok := alreadyLoggedEvents[*event.EventId]; ok { - continue - } - - e.handler.handle(event) - alreadyLoggedEvents[*event.EventId] = struct{}{} - } - - select { - case <-e.done: - // if nextToken is nil it mean we are at the end of the current pages. - // if not it mean we still have log to get and we need to report them before quitting. - if nextToken == nil { - return - } - case <-time.After(e.periodicCheck): - } - } -} - -type reportStackEvent struct { - skipBefore time.Time - callback func(event types.StackEvent) -} - -func (r *reportStackEvent) sync(event types.StackEvent) bool { - // Ignore anything before the Start pointer and everything which is not AWS::CloudFormation::Stack - if r.skipBefore.Before(*event.Timestamp) && *event.ResourceType == eventAWSCloudFormationStack { - // We are only interested in events thats `START` a request. - switch event.ResourceStatus { - case types.ResourceStatusCreateInProgress: - return false - case types.ResourceStatusDeleteInProgress: - return false - case types.ResourceStatusUpdateInProgress: - return false - default: - return true - } - } - return true -} - -func (r *reportStackEvent) handle(event types.StackEvent) { - r.callback(event) -} diff --git a/x-pack/functionbeat/manager/aws/event_stack_poller_test.go b/x-pack/functionbeat/manager/aws/event_stack_poller_test.go deleted file mode 100644 index 3679f07fb54..00000000000 --- a/x-pack/functionbeat/manager/aws/event_stack_poller_test.go +++ /dev/null @@ -1,341 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package aws - -import ( - "context" - "strconv" - "sync/atomic" - "testing" - "time" - - "github.com/aws/aws-sdk-go-v2/service/cloudformation/types" - - "github.com/aws/aws-sdk-go-v2/service/cloudformation" - "github.com/stretchr/testify/assert" - - "github.com/elastic/elastic-agent-libs/logp" -) - -type mockEventHandler struct { - skipEvents int32 - skipCount atomic.Int32 - events chan types.StackEvent -} - -func (m *mockEventHandler) sync(event types.StackEvent) bool { - if m.skipCount.Load() >= m.skipEvents { - return false - } - m.skipCount.Add(1) - return true -} - -func (m *mockEventHandler) handle(event types.StackEvent) { - m.events <- event -} - -type mockCloudFormationClient struct { - Responses []*cloudformation.DescribeStackEventsOutput - Index int -} - -func (m *mockCloudFormationClient) DescribeStackEvents(context.Context, *cloudformation.DescribeStackEventsInput, ...func(*cloudformation.Options)) (*cloudformation.DescribeStackEventsOutput, error) { - defer func() { - // This minic the fact that the last token will be nil. - if m.Index < len(m.Responses)-1 { - m.Index++ - } - }() - - return m.Responses[m.Index], nil -} - -func TestEventStackPoller(t *testing.T) { - t.Run("emits all events", testEmitAllEvents) - t.Run("skip events", testSkipEvents) - t.Run("skip duplicates", testSkipDuplicates) - t.Run("return time ordered events", testReturnTimeOrdered) -} - -func testEmitAllEvents(t *testing.T) { - response1 := &cloudformation.DescribeStackEventsOutput{ - NextToken: ptr("12345"), - StackEvents: []types.StackEvent{ - types.StackEvent{EventId: ptr("1"), Timestamp: ptrTime(time.Now())}, - types.StackEvent{EventId: ptr("2"), Timestamp: ptrTime(time.Now())}, - types.StackEvent{EventId: ptr("3"), Timestamp: ptrTime(time.Now())}, - types.StackEvent{EventId: ptr("4"), Timestamp: ptrTime(time.Now())}, - types.StackEvent{EventId: ptr("5"), Timestamp: ptrTime(time.Now())}, - }, - } - response2 := &cloudformation.DescribeStackEventsOutput{ - StackEvents: []types.StackEvent{ - types.StackEvent{EventId: ptr("6"), Timestamp: ptrTime(time.Now())}, - types.StackEvent{EventId: ptr("7"), Timestamp: ptrTime(time.Now())}, - types.StackEvent{EventId: ptr("8"), Timestamp: ptrTime(time.Now())}, - types.StackEvent{EventId: ptr("9"), Timestamp: ptrTime(time.Now())}, - types.StackEvent{EventId: ptr("10"), Timestamp: ptrTime(time.Now())}, - }, - } - - client := &mockCloudFormationClient{Responses: []*cloudformation.DescribeStackEventsOutput{ - response1, - response2, - }} - - handler := &mockEventHandler{events: make(chan types.StackEvent)} - poller := newEventStackPoller( - logp.NewLogger(""), - client, - ptr("1235"), - 1, - handler, - ) - poller.Start() - defer poller.Stop() - - var c int - for range handler.events { - c++ - if c == 10 { - return - } - } -} - -func testSkipEvents(t *testing.T) { - response1 := &cloudformation.DescribeStackEventsOutput{ - NextToken: ptr("12345"), - StackEvents: []types.StackEvent{ - types.StackEvent{EventId: ptr("1"), Timestamp: ptrTime(time.Now())}, - types.StackEvent{EventId: ptr("2"), Timestamp: ptrTime(time.Now())}, - types.StackEvent{EventId: ptr("3"), Timestamp: ptrTime(time.Now())}, - types.StackEvent{EventId: ptr("4"), Timestamp: ptrTime(time.Now())}, - types.StackEvent{EventId: ptr("5"), Timestamp: ptrTime(time.Now())}, - }, - } - response2 := &cloudformation.DescribeStackEventsOutput{ - StackEvents: []types.StackEvent{ - types.StackEvent{EventId: ptr("6"), Timestamp: ptrTime(time.Now())}, - types.StackEvent{EventId: ptr("7"), Timestamp: ptrTime(time.Now())}, - types.StackEvent{EventId: ptr("8"), Timestamp: ptrTime(time.Now())}, - types.StackEvent{EventId: ptr("9"), Timestamp: ptrTime(time.Now())}, - types.StackEvent{EventId: ptr("10"), Timestamp: ptrTime(time.Now())}, - }, - } - - client := &mockCloudFormationClient{Responses: []*cloudformation.DescribeStackEventsOutput{ - response1, - response2, - }} - - handler := &mockEventHandler{skipEvents: 3, events: make(chan types.StackEvent)} - poller := newEventStackPoller( - logp.NewLogger(""), - client, - ptr("1235"), - 0, - handler, - ) - poller.Start() - defer poller.Stop() - - var c int - for range handler.events { - c++ - if c == 7 { - return - } - } -} - -func testSkipDuplicates(t *testing.T) { - response1 := &cloudformation.DescribeStackEventsOutput{ - NextToken: ptr("12345"), - StackEvents: []types.StackEvent{ - types.StackEvent{EventId: ptr("1"), Timestamp: ptrTime(time.Now())}, - types.StackEvent{EventId: ptr("2"), Timestamp: ptrTime(time.Now())}, - types.StackEvent{EventId: ptr("3"), Timestamp: ptrTime(time.Now())}, - types.StackEvent{EventId: ptr("4"), Timestamp: ptrTime(time.Now())}, - types.StackEvent{EventId: ptr("4"), Timestamp: ptrTime(time.Now())}, - }, - } - response2 := &cloudformation.DescribeStackEventsOutput{ - StackEvents: []types.StackEvent{ - types.StackEvent{EventId: ptr("1"), Timestamp: ptrTime(time.Now())}, - types.StackEvent{EventId: ptr("2"), Timestamp: ptrTime(time.Now())}, - types.StackEvent{EventId: ptr("2"), Timestamp: ptrTime(time.Now())}, - types.StackEvent{EventId: ptr("4"), Timestamp: ptrTime(time.Now())}, - types.StackEvent{EventId: ptr("5"), Timestamp: ptrTime(time.Now())}, - }, - } - - client := &mockCloudFormationClient{Responses: []*cloudformation.DescribeStackEventsOutput{ - response1, - response2, - }} - - handler := &mockEventHandler{skipEvents: 3, events: make(chan types.StackEvent)} - poller := newEventStackPoller( - logp.NewLogger(""), - client, - ptr("1235"), - 0, - handler, - ) - poller.Start() - defer poller.Stop() - - var c int - for range handler.events { - c++ - if c == 4 { - return - } - } -} - -func testReturnTimeOrdered(t *testing.T) { - response1 := &cloudformation.DescribeStackEventsOutput{ - NextToken: ptr("12345"), - StackEvents: []types.StackEvent{ - types.StackEvent{EventId: ptr("5"), Timestamp: ptrTime(time.Now())}, - types.StackEvent{EventId: ptr("4"), Timestamp: ptrTime(time.Now())}, - types.StackEvent{EventId: ptr("3"), Timestamp: ptrTime(time.Now())}, - types.StackEvent{EventId: ptr("2"), Timestamp: ptrTime(time.Now())}, - types.StackEvent{EventId: ptr("1"), Timestamp: ptrTime(time.Now())}, - }, - } - - client := &mockCloudFormationClient{Responses: []*cloudformation.DescribeStackEventsOutput{ - response1, - }} - - handler := &mockEventHandler{events: make(chan types.StackEvent)} - poller := newEventStackPoller( - logp.NewLogger(""), - client, - ptr("1235"), - 0, - handler, - ) - poller.Start() - defer poller.Stop() - - c := 1 - for event := range handler.events { - if c == 5 { - return - } - - assert.Equal(t, strconv.Itoa(c), *event.EventId) - c++ - } -} - -func TestReportStackEvent(t *testing.T) { - t.Run("test skip event", testReportSkipEvents) - t.Run("test that handle forward the event to callback", testReportCallback) -} - -func testReportSkipEvents(t *testing.T) { - now := time.Now() - - tests := []struct { - name string - event types.StackEvent - sync bool - }{ - { - name: "is stack event but happened before", - event: types.StackEvent{ - ResourceType: ptr("AWS::CloudFormation::Stack"), - EventId: ptr("1"), - Timestamp: ptrTime(now.Add(-10 * time.Second)), - }, - sync: true, - }, - { - name: "is not a stack event", - event: types.StackEvent{ - ResourceType: ptr("AWS::S3::Bucket"), - EventId: ptr("2"), - Timestamp: ptrTime(now.Add(10 * time.Second)), - }, - sync: true, - }, - { - name: "is a stack event and happens after but with wrong status", - event: types.StackEvent{ - ResourceType: ptr("AWS::CloudFormation::Stack"), - ResourceStatus: types.ResourceStatusDeleteFailed, - EventId: ptr("2"), - Timestamp: ptrTime(now.Add(11 * time.Second)), - }, - sync: true, - }, - { - name: "is a stack event and happens after with a CREATE_IN_PROGRESS status", - event: types.StackEvent{ - ResourceType: ptr("AWS::CloudFormation::Stack"), - ResourceStatus: types.ResourceStatusCreateInProgress, - EventId: ptr("2"), - Timestamp: ptrTime(now.Add(11 * time.Second)), - }, - sync: false, - }, - { - name: "is a stack event and happens after with an UPDATE_IN_PROGRESS status", - event: types.StackEvent{ - ResourceType: ptr("AWS::CloudFormation::Stack"), - ResourceStatus: types.ResourceStatusUpdateInProgress, - EventId: ptr("2"), - Timestamp: ptrTime(now.Add(11 * time.Second)), - }, - sync: false, - }, - { - name: "is a stack event and happens after with an DELETE_IN_PROGRESS status", - event: types.StackEvent{ - ResourceType: ptr("AWS::CloudFormation::Stack"), - ResourceStatus: types.ResourceStatusDeleteInProgress, - EventId: ptr("2"), - Timestamp: ptrTime(now.Add(11 * time.Second)), - }, - sync: false, - }, - } - - reporter := reportStackEvent{ - skipBefore: now, - callback: func(event types.StackEvent) {}, - } - - for _, test := range tests { - t.Run(test.name, func(t *testing.T) { - assert.Equal(t, test.sync, reporter.sync(test.event)) - }) - } -} - -func testReportCallback(t *testing.T) { - var received bool - reporter := reportStackEvent{ - skipBefore: time.Now(), - callback: func(event types.StackEvent) { received = true }, - } - - reporter.handle(types.StackEvent{}) - assert.True(t, received) -} - -func ptr(v string) *string { - return &v -} - -func ptrTime(t time.Time) *time.Time { - return &t -} diff --git a/x-pack/functionbeat/manager/aws/op_cloudformation.go b/x-pack/functionbeat/manager/aws/op_cloudformation.go deleted file mode 100644 index 028c78cd4a4..00000000000 --- a/x-pack/functionbeat/manager/aws/op_cloudformation.go +++ /dev/null @@ -1,110 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package aws - -import ( - "context" - "fmt" - "strings" - "time" - - "github.com/aws/aws-sdk-go-v2/service/cloudformation/types" - - "github.com/aws/aws-sdk-go-v2/aws" - "github.com/aws/aws-sdk-go-v2/service/cloudformation" - "github.com/gofrs/uuid/v5" - - "github.com/elastic/beats/v7/x-pack/functionbeat/manager/executor" - "github.com/elastic/elastic-agent-libs/logp" -) - -type opCreateCloudFormation struct { - log *logp.Logger - svc createStackClient - templateURL string - stackName string -} - -func newOpCreateCloudFormation( - log *logp.Logger, - svc createStackClient, - templateURL, stackName string, -) *opCreateCloudFormation { - return &opCreateCloudFormation{ - log: log, - svc: svc, - templateURL: templateURL, - stackName: stackName, - } -} - -func (o *opCreateCloudFormation) Execute(ctx executor.Context) error { - c, ok := ctx.(*stackContext) - if !ok { - return errWrongContext - } - - o.log.Debug("Creating CloudFormation create stack request") - uuid, err := uuid.NewV4() - if err != nil { - return err - } - input := &cloudformation.CreateStackInput{ - ClientRequestToken: aws.String(uuid.String()), - StackName: aws.String(o.stackName), - TemplateURL: aws.String(o.templateURL), - Capabilities: []types.Capability{ - types.CapabilityCapabilityNamedIam, - }, - } - - resp, err := o.svc.CreateStack(context.TODO(), input) - if err != nil { - o.log.Debugf("Could not create the CloudFormation stack request, resp: %v", resp) - return err - } - - c.ID = resp.StackId - - return nil -} - -func makeEventStackPoller( - log *logp.Logger, - svc *cloudformation.Client, - periodicCheck time.Duration, - ctx *stackContext, -) *eventStackPoller { - return newEventStackPoller( - log, - svc, - ctx.ID, - periodicCheck, - &reportStackEvent{skipBefore: ctx.StartedAt, callback: func(event types.StackEvent) { - // Returned values for a stack events are hit or miss, so lets try to create a - // meaningful string. - var buf strings.Builder - fmt.Fprintf(&buf, "Stack event received") - - writeOptKV(&buf, "ResourceType", event.ResourceType) - writeOptKV(&buf, "LogicalResourceId", event.LogicalResourceId) - s := string(event.ResourceStatus) - writeOptKV(&buf, "ResourceStatus", &s) - writeOptKV(&buf, "ResourceStatusReason", event.ResourceStatusReason) - - log.Info(buf.String()) - }}, - ) -} - -func writeKV(buf *strings.Builder, key string, value string) { - fmt.Fprintf(buf, ", %s: %s", key, value) -} - -func writeOptKV(buf *strings.Builder, key string, value *string) { - if value != nil { - writeKV(buf, key, *value) - } -} diff --git a/x-pack/functionbeat/manager/aws/op_cloudformation_test.go b/x-pack/functionbeat/manager/aws/op_cloudformation_test.go deleted file mode 100644 index 767b638083b..00000000000 --- a/x-pack/functionbeat/manager/aws/op_cloudformation_test.go +++ /dev/null @@ -1,211 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package aws - -import ( - "context" - "errors" - "testing" - - "github.com/aws/aws-sdk-go-v2/service/cloudformation/types" - - "github.com/aws/aws-sdk-go-v2/service/cloudformation" - "github.com/stretchr/testify/assert" - - "github.com/elastic/elastic-agent-libs/logp" -) - -type mockCloudformationStack struct { - respCreateStackOutput *cloudformation.CreateStackOutput - onCreateStackInput func(*cloudformation.CreateStackInput) - - respDeleteStackOutput *cloudformation.DeleteStackOutput - onDeleteStackInput func(*cloudformation.DeleteStackInput) - - respDescribeStacksOutput *cloudformation.DescribeStacksOutput - onDescribeStacksInput func(*cloudformation.DescribeStacksInput) - - respUpdateStackOutput *cloudformation.UpdateStackOutput - onUpdateStackInput func(*cloudformation.UpdateStackInput) - err error -} - -func (m *mockCloudformationStack) CreateStack(ctx context.Context, params *cloudformation.CreateStackInput, optFns ...func(*cloudformation.Options)) (*cloudformation.CreateStackOutput, error) { - if m.onCreateStackInput != nil { - m.onCreateStackInput(params) - } - - if m.err != nil { - return m.respCreateStackOutput, m.err - } - - return m.respCreateStackOutput, nil -} - -func (m *mockCloudformationStack) DeleteStack(ctx context.Context, params *cloudformation.DeleteStackInput, optFns ...func(*cloudformation.Options)) (*cloudformation.DeleteStackOutput, error) { - if m.onDeleteStackInput != nil { - m.onDeleteStackInput(params) - } - - if m.err != nil { - return m.respDeleteStackOutput, m.err - } - - return m.respDeleteStackOutput, nil -} - -func (m *mockCloudformationStack) DescribeStacks(ctx context.Context, params *cloudformation.DescribeStacksInput, optFns ...func(*cloudformation.Options)) (*cloudformation.DescribeStacksOutput, error) { - if m.onDescribeStacksInput != nil { - m.onDescribeStacksInput(params) - } - - if m.err != nil { - return m.respDescribeStacksOutput, m.err - } - - return m.respDescribeStacksOutput, nil -} - -func (m *mockCloudformationStack) UpdateStack(ctx context.Context, params *cloudformation.UpdateStackInput, optFns ...func(*cloudformation.Options)) (*cloudformation.UpdateStackOutput, error) { - if m.onUpdateStackInput != nil { - m.onUpdateStackInput(params) - } - - if m.err != nil { - return m.respUpdateStackOutput, m.err - } - - return m.respUpdateStackOutput, nil -} - -func TestCreateStack(t *testing.T) { - stackName := "new-stack" - stackID := "new-stack-ID" - templateURL := "https://localhost/stack.zip" - log := logp.NewLogger("") - - t.Run("assert execution context", func(t *testing.T) { - op := &opCreateCloudFormation{} - err := op.Execute(struct{}{}) - assert.Error(t, err) - }) - - t.Run("create stack", func(t *testing.T) { - mockSvc := &mockCloudformationStack{respCreateStackOutput: &cloudformation.CreateStackOutput{ - StackId: &stackID, - }, onCreateStackInput: func(input *cloudformation.CreateStackInput) { - assert.Equal(t, stackName, *input.StackName) - assert.Equal(t, templateURL, *input.TemplateURL) - }} - - ctx := &stackContext{} - op := newOpCreateCloudFormation(log, mockSvc, templateURL, stackName) - err := op.Execute(ctx) - if !assert.NoError(t, err) { - return - } - - assert.Equal(t, stackID, *ctx.ID) - }) - - t.Run("bubble any stack error back to the caller", func(t *testing.T) { - anErr := errors.New("something is bad") - mockSvc := &mockCloudformationStack{err: anErr} - - ctx := &stackContext{} - op := newOpCreateCloudFormation(log, mockSvc, templateURL, stackName) - err := op.Execute(ctx) - assert.Equal(t, anErr, err) - }) -} - -func TestDeleteStack(t *testing.T) { - stackName := "new-stack" - stackID := "new-stack-ID" - log := logp.NewLogger("") - - t.Run("assert execution context", func(t *testing.T) { - op := &opDeleteCloudFormation{} - err := op.Execute(struct{}{}) - assert.Error(t, err) - }) - - t.Run("delete stack", func(t *testing.T) { - mockSvc := &mockCloudformationStack{ - respDeleteStackOutput: &cloudformation.DeleteStackOutput{}, - onDeleteStackInput: func( - input *cloudformation.DeleteStackInput, - ) { - assert.Equal(t, stackName, *input.StackName) - }, - respDescribeStacksOutput: &cloudformation.DescribeStacksOutput{ - Stacks: []types.Stack{types.Stack{StackId: &stackID}}, - }, - } - ctx := &stackContext{} - op := newOpDeleteCloudFormation(log, mockSvc, stackName) - err := op.Execute(ctx) - if !assert.NoError(t, err) { - return - } - - assert.Equal(t, stackID, *ctx.ID) - }) - - t.Run("bubble any stack error back to the caller", func(t *testing.T) { - anErr := errors.New("something is bad") - mockSvc := &mockCloudformationStack{err: anErr} - - ctx := &stackContext{} - op := newOpDeleteCloudFormation(log, mockSvc, stackName) - err := op.Execute(ctx) - assert.Equal(t, anErr, err) - }) -} - -func TestUpdateStack(t *testing.T) { - stackName := "new-stack" - stackID := "new-stack-ID" - templateURL := "https://localhost/stack.zip" - log := logp.NewLogger("") - - t.Run("assert execution context", func(t *testing.T) { - op := &opDeleteCloudFormation{} - err := op.Execute(struct{}{}) - assert.Error(t, err) - }) - - t.Run("update stack", func(t *testing.T) { - mockSvc := &mockCloudformationStack{ - onUpdateStackInput: func( - input *cloudformation.UpdateStackInput, - ) { - assert.Equal(t, stackName, *input.StackName) - assert.Equal(t, templateURL, *input.TemplateURL) - }, - respUpdateStackOutput: &cloudformation.UpdateStackOutput{ - StackId: &stackID, - }, - } - ctx := &stackContext{} - op := newOpUpdateCloudFormation(log, mockSvc, templateURL, stackName) - err := op.Execute(ctx) - if !assert.NoError(t, err) { - return - } - - assert.Equal(t, stackID, *ctx.ID) - }) - - t.Run("bubble any stack error back to the caller", func(t *testing.T) { - anErr := errors.New("something is bad") - mockSvc := &mockCloudformationStack{err: anErr} - - ctx := &stackContext{} - op := newOpUpdateCloudFormation(log, mockSvc, templateURL, stackName) - err := op.Execute(ctx) - assert.Equal(t, anErr, err) - }) -} diff --git a/x-pack/functionbeat/manager/aws/op_delete_cloudformation.go b/x-pack/functionbeat/manager/aws/op_delete_cloudformation.go deleted file mode 100644 index 4954e70b266..00000000000 --- a/x-pack/functionbeat/manager/aws/op_delete_cloudformation.go +++ /dev/null @@ -1,63 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package aws - -import ( - "context" - - "github.com/aws/aws-sdk-go-v2/aws" - "github.com/aws/aws-sdk-go-v2/service/cloudformation" - "github.com/gofrs/uuid/v5" - - "github.com/elastic/beats/v7/x-pack/functionbeat/manager/executor" - "github.com/elastic/elastic-agent-libs/logp" -) - -type opDeleteCloudFormation struct { - log *logp.Logger - svc deleteStackClient - stackName string -} - -func (o *opDeleteCloudFormation) Execute(ctx executor.Context) error { - c, ok := ctx.(*stackContext) - if !ok { - return errWrongContext - } - - uuid, err := uuid.NewV4() - if err != nil { - return err - } - - // retrieve the stack id from the name so we can have access to the Stack events when the - // stack is completely deleted. - stackID, err := queryStackID(o.svc, aws.String(o.stackName)) - if err != nil { - return err - } - c.ID = stackID - - input := &cloudformation.DeleteStackInput{ - ClientRequestToken: aws.String(uuid.String()), - StackName: aws.String(o.stackName), - } - - resp, err := o.svc.DeleteStack(context.TODO(), input) - if err != nil { - o.log.Debugf("Could not delete the stack, response: %v", resp) - return err - } - - return nil -} - -func newOpDeleteCloudFormation( - log *logp.Logger, - svc deleteStackClient, - stackName string, -) *opDeleteCloudFormation { - return &opDeleteCloudFormation{log: log, svc: svc, stackName: stackName} -} diff --git a/x-pack/functionbeat/manager/aws/op_delete_file_bucket.go b/x-pack/functionbeat/manager/aws/op_delete_file_bucket.go deleted file mode 100644 index e30664fde5b..00000000000 --- a/x-pack/functionbeat/manager/aws/op_delete_file_bucket.go +++ /dev/null @@ -1,52 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package aws - -import ( - "context" - - "github.com/aws/aws-sdk-go-v2/aws" - "github.com/aws/aws-sdk-go-v2/service/s3" - - "github.com/elastic/beats/v7/x-pack/functionbeat/manager/executor" - "github.com/elastic/elastic-agent-libs/logp" -) - -type opDeleteFileBucket struct { - log *logp.Logger - svc *s3.Client - bucketName string - path string -} - -func newOpDeleteFileBucket( - log *logp.Logger, - config aws.Config, - bucketName, path string, -) *opDeleteFileBucket { - return &opDeleteFileBucket{ - log: log, - svc: s3.NewFromConfig(config), - bucketName: bucketName, - path: path, - } -} - -func (o *opDeleteFileBucket) Execute(_ executor.Context) error { - o.log.Debugf("Removing file '%s' on bucket '%s'", o.path, o.bucketName) - input := &s3.DeleteObjectInput{ - Bucket: aws.String(o.bucketName), - Key: aws.String(o.path), - } - - resp, err := o.svc.DeleteObject(context.TODO(), input) - - if err != nil { - o.log.Debugf("Could not remove object to S3, resp: %v", resp) - return err - } - o.log.Debug("Remove successful") - return nil -} diff --git a/x-pack/functionbeat/manager/aws/op_ensure_bucket.go b/x-pack/functionbeat/manager/aws/op_ensure_bucket.go deleted file mode 100644 index f394650c119..00000000000 --- a/x-pack/functionbeat/manager/aws/op_ensure_bucket.go +++ /dev/null @@ -1,61 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package aws - -import ( - "context" - "errors" - "fmt" - - "github.com/aws/smithy-go" - - "github.com/aws/aws-sdk-go-v2/aws" - "github.com/aws/aws-sdk-go-v2/service/s3" - - "github.com/elastic/beats/v7/x-pack/functionbeat/manager/executor" - "github.com/elastic/elastic-agent-libs/logp" -) - -// This error is not provided by the S3 error package. -const notFound = "NotFound" - -type opEnsureBucket struct { - log *logp.Logger - svc *s3.Client - bucketName string -} - -func newOpEnsureBucket(log *logp.Logger, cfg aws.Config, bucketName string) *opEnsureBucket { - return &opEnsureBucket{log: log, svc: s3.NewFromConfig(cfg), bucketName: bucketName} -} - -func (o *opEnsureBucket) Execute(_ executor.Context) error { - o.log.Debugf("Verifying presence of S3 bucket: %s", o.bucketName) - - check := &s3.HeadBucketInput{Bucket: aws.String(o.bucketName)} - _, err := o.svc.HeadBucket(context.TODO(), check) - if err == nil { - // The bucket exists and we have permission to access it. - return nil - } - - var apiError smithy.APIError - if errors.As(err, &apiError) { - if apiError.ErrorCode() == notFound { - // bucket do not exist let's create it. - input := &s3.CreateBucketInput{Bucket: aws.String(o.bucketName)} - resp, err := o.svc.CreateBucket(context.TODO(), input) - if err != nil { - o.log.Debugf("Could not create bucket, resp: %v", resp) - return err - } - // bucket created successfully - return nil - } - } - - // Catchall for unauthorized access. - return fmt.Errorf("bucket '%s' already exist and you don't have permission to access it: %w", o.bucketName, err) -} diff --git a/x-pack/functionbeat/manager/aws/op_update_cloudformation.go b/x-pack/functionbeat/manager/aws/op_update_cloudformation.go deleted file mode 100644 index 9a75909f247..00000000000 --- a/x-pack/functionbeat/manager/aws/op_update_cloudformation.go +++ /dev/null @@ -1,68 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package aws - -import ( - "context" - - "github.com/aws/aws-sdk-go-v2/service/cloudformation/types" - - "github.com/aws/aws-sdk-go-v2/aws" - "github.com/aws/aws-sdk-go-v2/service/cloudformation" - "github.com/gofrs/uuid/v5" - - "github.com/elastic/beats/v7/x-pack/functionbeat/manager/executor" - "github.com/elastic/elastic-agent-libs/logp" -) - -type opUpdateCloudFormation struct { - log *logp.Logger - svc updateStackClient - templateURL string - stackName string -} - -func (o *opUpdateCloudFormation) Execute(ctx executor.Context) error { - c, ok := ctx.(*stackContext) - if !ok { - return errWrongContext - } - - uuid, err := uuid.NewV4() - if err != nil { - return err - } - input := &cloudformation.UpdateStackInput{ - ClientRequestToken: aws.String(uuid.String()), - StackName: aws.String(o.stackName), - TemplateURL: aws.String(o.templateURL), - Capabilities: []types.Capability{ - types.CapabilityCapabilityNamedIam, - }, - } - - resp, err := o.svc.UpdateStack(context.TODO(), input) - if err != nil { - o.log.Debugf("Could not update the cloudformation stack, resp: %+v", resp) - return err - } - - c.ID = resp.StackId - - return nil -} - -func newOpUpdateCloudFormation( - log *logp.Logger, - svc updateStackClient, - templateURL, stackName string, -) *opUpdateCloudFormation { - return &opUpdateCloudFormation{ - log: log, - svc: svc, - templateURL: templateURL, - stackName: stackName, - } -} diff --git a/x-pack/functionbeat/manager/aws/op_upload_to_bucket.go b/x-pack/functionbeat/manager/aws/op_upload_to_bucket.go deleted file mode 100644 index 0825a26b35a..00000000000 --- a/x-pack/functionbeat/manager/aws/op_upload_to_bucket.go +++ /dev/null @@ -1,68 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package aws - -import ( - "bytes" - "context" - - "github.com/aws/aws-sdk-go-v2/aws" - "github.com/aws/aws-sdk-go-v2/service/s3" - - "github.com/elastic/beats/v7/x-pack/functionbeat/manager/executor" - "github.com/elastic/elastic-agent-libs/logp" -) - -type opUploadToBucket struct { - log *logp.Logger - svc *s3.Client - bucketName string - path string - raw []byte - config aws.Config -} - -func newOpUploadToBucket( - log *logp.Logger, - config aws.Config, - bucketName, path string, - raw []byte, -) *opUploadToBucket { - return &opUploadToBucket{ - log: log, - svc: s3.NewFromConfig(config), - bucketName: bucketName, - path: path, - raw: raw, - config: config, - } -} - -func (o *opUploadToBucket) Execute(_ executor.Context) error { - o.log.Debugf("Uploading file '%s' to bucket '%s' with size %d bytes", o.path, o.bucketName, len(o.raw)) - input := &s3.PutObjectInput{ - Bucket: aws.String(o.bucketName), - Body: bytes.NewReader(o.raw), - Key: aws.String(o.path), - } - resp, err := o.svc.PutObject(context.TODO(), input) - - if err != nil { - o.log.Debugf("Could not upload object to S3, resp: %v", resp) - return err - } - o.log.Debug("Upload successful") - return nil -} - -func (o *opUploadToBucket) Rollback(ctx executor.Context) error { - // The error will be logged but we do not enforce a hard failure because the file could have - // been removed before. - err := newOpDeleteFileBucket(o.log, o.config, o.bucketName, o.path).Execute(ctx) - if err != nil { - o.log.Debugf("Fail to delete file on bucket, error: %+v", err) - } - return nil -} diff --git a/x-pack/functionbeat/manager/aws/op_wait_cloud_formation.go b/x-pack/functionbeat/manager/aws/op_wait_cloud_formation.go deleted file mode 100644 index 7a800fc9773..00000000000 --- a/x-pack/functionbeat/manager/aws/op_wait_cloud_formation.go +++ /dev/null @@ -1,145 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package aws - -import ( - "context" - "errors" - "time" - - "github.com/aws/aws-sdk-go-v2/service/cloudformation/types" - - "github.com/aws/aws-sdk-go-v2/aws" - "github.com/aws/aws-sdk-go-v2/service/cloudformation" - - "github.com/elastic/beats/v7/x-pack/functionbeat/manager/executor" - "github.com/elastic/elastic-agent-libs/logp" -) - -var periodicCheck = 2 * time.Second - -type checkStatusFunc = func(status *types.StackStatus) (bool, error) - -type opWaitCloudFormation struct { - log *logp.Logger - svc *cloudformation.Client - checkStatus checkStatusFunc -} - -func newOpWaitCloudFormation( - log *logp.Logger, - svc *cloudformation.Client, -) *opWaitCloudFormation { - return &opWaitCloudFormation{ - log: log, - svc: svc, - checkStatus: checkCreateStatus, - } -} - -func newWaitDeleteCloudFormation( - log *logp.Logger, - cfg aws.Config, -) *opWaitCloudFormation { - return &opWaitCloudFormation{ - log: log, - svc: cloudformation.NewFromConfig(cfg), - checkStatus: checkDeleteStatus, - } -} - -func (o *opWaitCloudFormation) Execute(ctx executor.Context) error { - c, ok := ctx.(*stackContext) - if !ok { - return errWrongContext - } - - if c.ID == nil { - return errMissingStackID - } - - eventStackPoller := makeEventStackPoller(o.log, o.svc, periodicCheck, c) - eventStackPoller.Start() - defer eventStackPoller.Stop() - - for { - status, _, err := queryStackStatus(o.svc, c.ID) - if err != nil { - return err - } - - completed, err := o.checkStatus(status) - if err != nil { - return err - } - - if completed { - return nil - } - - <-time.After(periodicCheck) - } -} - -func checkCreateStatus(status *types.StackStatus) (bool, error) { - switch *status { - case types.StackStatusUpdateComplete: // OK - return true, nil - case types.StackStatusCreateComplete: // OK - return true, nil - case types.StackStatusRollbackFailed: - return true, errors.New("failed to create and rollback the stack") - case types.StackStatusRollbackComplete: - return true, errors.New("failed to create the stack") - } - return false, nil -} - -func checkDeleteStatus(status *types.StackStatus) (bool, error) { - switch *status { - case types.StackStatusDeleteComplete: // OK - return true, nil - case types.StackStatusDeleteFailed: - return true, errors.New("failed to delete the stack") - case types.StackStatusRollbackFailed: - return true, errors.New("failed to delete and rollback the stack") - case types.StackStatusRollbackComplete: - return true, errors.New("failed to delete the stack") - } - return false, nil -} - -func queryStack( - svc cloudformation.DescribeStacksAPIClient, - stackID *string, -) (*cloudformation.DescribeStacksOutput, error) { - input := &cloudformation.DescribeStacksInput{StackName: stackID} - resp, err := svc.DescribeStacks(context.TODO(), input) - if err != nil { - return nil, err - } - return resp, nil -} - -func queryStackStatus( - svc cloudformation.DescribeStacksAPIClient, - stackID *string, -) (*types.StackStatus, *string, error) { - resp, err := queryStack(svc, stackID) - if err != nil { - return nil, nil, err - } - - stack := resp.Stacks[0] - return &stack.StackStatus, stack.StackStatusReason, nil -} - -func queryStackID(svc cloudformation.DescribeStacksAPIClient, stackName *string) (*string, error) { - resp, err := queryStack(svc, stackName) - if err != nil { - return nil, err - } - return resp.Stacks[0].StackId, nil -} diff --git a/x-pack/functionbeat/manager/aws/policies_test.go b/x-pack/functionbeat/manager/aws/policies_test.go deleted file mode 100644 index 30b484d0b35..00000000000 --- a/x-pack/functionbeat/manager/aws/policies_test.go +++ /dev/null @@ -1,71 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package aws - -import ( - "testing" - - "github.com/awslabs/goformation/v7/cloudformation" - "github.com/awslabs/goformation/v7/cloudformation/iam" - "github.com/stretchr/testify/assert" - - "github.com/elastic/beats/v7/x-pack/functionbeat/function/provider" - fnaws "github.com/elastic/beats/v7/x-pack/functionbeat/provider/aws/aws" - conf "github.com/elastic/elastic-agent-libs/config" -) - -func TestConfig(t *testing.T) { - t.Run("test permissions for event_source_arn", testPolicies) -} - -func testPolicies(t *testing.T) { - cfg := conf.MustNewConfigFrom(map[string]interface{}{ - "name": "myfunction", - "description": "mydescription", - "triggers": []map[string]interface{}{ - map[string]interface{}{ - "event_source_arn": "abc456", - }, - map[string]interface{}{ - "event_source_arn": "abc1234", - }, - }, - }) - - k, err := fnaws.NewKinesis(&provider.DefaultProvider{}, cfg) - if !assert.NoError(t, err) { - return - } - - i, ok := k.(installer) - if !assert.True(t, ok) { - return - } - - policies := i.Policies() - if !assert.Equal(t, 1, len(policies)) { - return - } - - // ensure permissions on specified resources - expected := iam.Role_Policy{ - PolicyName: cloudformation.Join("-", []string{"fnb", "kinesis", "myfunction"}), - PolicyDocument: map[string]interface{}{ - "Statement": []map[string]interface{}{ - map[string]interface{}{ - "Action": []string{ - "kinesis:GetRecords", - "kinesis:GetShardIterator", - "Kinesis:DescribeStream", - }, - "Effect": "Allow", - "Resource": []string{"abc1234", "abc456"}, - }, - }, - }, - } - - assert.Equal(t, expected, policies[0]) -} diff --git a/x-pack/functionbeat/manager/aws/stack_context.go b/x-pack/functionbeat/manager/aws/stack_context.go deleted file mode 100644 index 638422cb5bb..00000000000 --- a/x-pack/functionbeat/manager/aws/stack_context.go +++ /dev/null @@ -1,24 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package aws - -import ( - "errors" - "time" -) - -var ( - errWrongContext = errors.New("invalid type, expecting stack context") - errMissingStackID = errors.New("missing stack id") -) - -type stackContext struct { - ID *string - StartedAt time.Time -} - -func newStackContext() *stackContext { - return &stackContext{StartedAt: time.Now()} -} diff --git a/x-pack/functionbeat/manager/aws/template_builder.go b/x-pack/functionbeat/manager/aws/template_builder.go deleted file mode 100644 index d988f60d708..00000000000 --- a/x-pack/functionbeat/manager/aws/template_builder.go +++ /dev/null @@ -1,331 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package aws - -import ( - "crypto/sha256" - "encoding/base64" - "errors" - "fmt" - - "github.com/awslabs/goformation/v7/cloudformation" - "github.com/awslabs/goformation/v7/cloudformation/iam" - "github.com/awslabs/goformation/v7/cloudformation/lambda" - "github.com/awslabs/goformation/v7/cloudformation/logs" - "github.com/awslabs/goformation/v7/cloudformation/tags" - - "github.com/elastic/beats/v7/x-pack/functionbeat/function/provider" - "github.com/elastic/beats/v7/x-pack/functionbeat/manager/core" - "github.com/elastic/beats/v7/x-pack/functionbeat/manager/core/bundle" - fnaws "github.com/elastic/beats/v7/x-pack/functionbeat/provider/aws/aws" - conf "github.com/elastic/elastic-agent-libs/config" - "github.com/elastic/elastic-agent-libs/logp" -) - -// zipData stores the data on the zip to be deployed -type zipData struct { - content []byte - checksum string -} - -// templateData stores the template and its metadata required to deploy it -type templateData struct { - json []byte - checksum string - key string - url string - codeKey string - zip zipData -} - -type defaultTemplateBuilder struct { - provider provider.Provider - log *logp.Logger - endpoint string - bucket string -} - -const ( - keyPrefix = "functionbeat-deployment/" - - // Package size limits for AWS, we should be a lot under this limit but - // adding a check to make sure we never go over. - // Ref: https://docs.aws.amazon.com/lambda/latest/dg/limits.html - packageCompressedLimit = 50 * 1000 * 1000 // 50MB - packageUncompressedLimit = 250 * 1000 * 1000 // 250MB -) - -func NewTemplateBuilder(log *logp.Logger, cfg *conf.C, p provider.Provider) (provider.TemplateBuilder, error) { - config := &fnaws.Config{} - if err := cfg.Unpack(config); err != nil { - return nil, err - } - - return &defaultTemplateBuilder{ - provider: p, - log: log, - endpoint: config.Credentials.Endpoint, - bucket: string(config.DeployBucket), - }, nil -} - -func (d *defaultTemplateBuilder) findFunction(name string) (installer, error) { - fn, err := d.provider.FindFunctionByName(name) - if err != nil { - return nil, err - } - - function, ok := fn.(installer) - if !ok { - return nil, errors.New("incompatible type received, expecting: 'functionManager'") - } - - return function, nil -} - -// execute generates a template -func (d *defaultTemplateBuilder) execute(name string) (templateData, error) { - d.log.Debug("Compressing all assets into an artifact") - - content, err := core.MakeZip(packageUncompressedLimit, packageCompressedLimit, zipResources()) - if err != nil { - return templateData{}, err - } - d.log.Debugf("Compression is successful (zip size: %d bytes)", len(content)) - - function, err := d.findFunction(name) - if err != nil { - return templateData{}, err - } - - fnTemplate := function.Template() - - zipChecksum := checksum(content) - codeKey := keyPrefix + name + "/" + zipChecksum + "/functionbeat.zip" - to := d.template(function, name, codeKey) - if err := mergeTemplate(to, fnTemplate); err != nil { - return templateData{}, err - } - - templateJSON, err := to.JSON() - if err != nil { - return templateData{}, err - } - - templateChecksum := checksum(templateJSON) - templateKey := keyPrefix + name + "/" + templateChecksum + "/cloudformation-template-create.json" - templateURL := "https://" + d.bucket + "." + d.endpoint + "/" + templateKey - - return templateData{ - json: templateJSON, - checksum: templateChecksum, - key: templateKey, - url: templateURL, - codeKey: codeKey, - zip: zipData{ - checksum: zipChecksum, - content: content, - }, - }, nil -} - -func (d *defaultTemplateBuilder) template(function installer, name, codeLoc string) *cloudformation.Template { - lambdaConfig := function.LambdaConfig() - - prefix := func(s string) string { - return fnaws.NormalizeResourceName("fnb" + name + s) - } - - // AWS variables references:. - // AWS::Partition: aws, aws-cn, aws-gov. - // AWS::Region: us-east-1, us-east-2, ap-northeast-3, - // AWS::AccountId: account id for the current request. - // AWS::URLSuffix: amazonaws.com - // - // Documentation: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/Welcome.html - // Intrinsic function reference: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference.html - - template := cloudformation.NewTemplate() - - role := lambdaConfig.Role - dependsOn := make([]string, 0) - if lambdaConfig.Role == "" { - d.log.Infof("No role is configured for function %s, creating a custom role.", name) - - roleRes := prefix("") + "IAMRoleLambdaExecution" - template.Resources[roleRes] = d.roleTemplate(function, name) - role = cloudformation.GetAtt(roleRes, "Arn") - dependsOn = []string{roleRes} - } - - // Configure the Dead letter, any failed events will be send to the configured amazon resource name. - var dlc *lambda.Function_DeadLetterConfig - if lambdaConfig.DeadLetterConfig != nil && len(lambdaConfig.DeadLetterConfig.TargetArn) != 0 { - dlc = &lambda.Function_DeadLetterConfig{ - TargetArn: cloudformation.String(lambdaConfig.DeadLetterConfig.TargetArn), - } - } - - // Configure VPC - var vcpConf *lambda.Function_VpcConfig - if lambdaConfig.VPCConfig != nil && len(lambdaConfig.VPCConfig.SecurityGroupIDs) != 0 && len(lambdaConfig.VPCConfig.SubnetIDs) != 0 { - vcpConf = &lambda.Function_VpcConfig{ - SecurityGroupIds: lambdaConfig.VPCConfig.SecurityGroupIDs, - SubnetIds: lambdaConfig.VPCConfig.SubnetIDs, - } - } - - ts := make([]tags.Tag, 0, len(lambdaConfig.Tags)) - for name, val := range lambdaConfig.Tags { - tag := tags.Tag{ - Key: name, - Value: val, - } - ts = append(ts, tag) - } - - // Create the lambda - // Doc: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html - template.Resources[prefix("")] = &AWSLambdaFunction{ - Function: &lambda.Function{ - Code: &lambda.Function_Code{ - S3Bucket: cloudformation.String(d.bucket), - S3Key: cloudformation.String(codeLoc), - }, - Description: cloudformation.String(lambdaConfig.Description), - Environment: &lambda.Function_Environment{ - // Configure which function need to be run by the lambda function. - Variables: map[string]string{ - "BEAT_STRICT_PERMS": "false", // Disable any check on disk, we are running with really differents permission on lambda. - "ENABLED_FUNCTIONS": name, - }, - }, - DeadLetterConfig: dlc, - VpcConfig: vcpConf, - FunctionName: cloudformation.String(name), - Role: role, - Runtime: cloudformation.String(runtime), - Handler: cloudformation.String(handlerName), - MemorySize: cloudformation.Int(lambdaConfig.MemorySize.Megabytes()), - ReservedConcurrentExecutions: cloudformation.Int(lambdaConfig.Concurrency), - Timeout: cloudformation.Int(int(lambdaConfig.Timeout.Seconds())), - Tags: ts, - }, - DependsOn: dependsOn, - } - - // Create the log group for the specific function lambda. - template.Resources[prefix("LogGroup")] = &logs.LogGroup{ - LogGroupName: cloudformation.String("/aws/lambda/" + name), - } - - return template -} - -func (d *defaultTemplateBuilder) roleTemplate(function installer, name string) *iam.Role { - // Default policies to writes logs from the Lambda. - policies := []iam.Role_Policy{ - iam.Role_Policy{ - PolicyName: cloudformation.Join("-", []string{"fnb", "lambda", name}), - PolicyDocument: map[string]interface{}{ - "Statement": []map[string]interface{}{ - map[string]interface{}{ - "Action": []string{"logs:CreateLogStream", "logs:PutLogEvents"}, - "Effect": "Allow", - "Resource": []string{ - cloudformation.Sub("arn:${AWS::Partition}:logs:${AWS::Region}:${AWS::AccountId}:log-group:/aws/lambda/" + name + ":*"), - }, - }, - }, - }, - }, - } - - // Merge any specific policies from the service. - policies = append(policies, function.Policies()...) - - // Create the roles for the lambda. - // doc: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html - return &iam.Role{ - AssumeRolePolicyDocument: map[string]interface{}{ - "Statement": []interface{}{ - map[string]interface{}{ - "Action": "sts:AssumeRole", - "Effect": "Allow", - "Principal": map[string]interface{}{ - "Service": cloudformation.Join("", []string{ - "lambda.", - cloudformation.Ref("AWS::URLSuffix"), - }), - }, - }, - }, - }, - Path: cloudformation.String("/"), - RoleName: cloudformation.String("functionbeat-lambda-" + name + "-" + cloudformation.Ref("AWS::Region")), - // Allow the lambda to write log to cloudwatch logs. - // doc: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html - Policies: policies, - } -} - -// RawTemplate generates a template and returns it in a string -func (d *defaultTemplateBuilder) RawTemplate(name string) (string, error) { - data, err := d.execute(name) - return string(data.json), err -} - -func merge[M1 ~map[K]V, M2 ~map[K]V, K comparable, V any](m1 M1, m2 M2) error { - for k, v := range m2 { - if _, ok := m1[k]; ok { - return fmt.Errorf("key %v already exist in the template map", k) - } - m1[k] = v - } - return nil -} - -// mergeTemplate takes two cloudformation and merge them, if a key already exist we return an error. -func mergeTemplate(to, from *cloudformation.Template) error { - err := merge(to.Parameters, from.Parameters) - if err != nil { - return err - } - - err = merge(to.Mappings, from.Mappings) - if err != nil { - return err - } - - err = merge(to.Conditions, from.Conditions) - if err != nil { - return err - } - - for k, v := range from.Resources { - if _, ok := to.Resources[k]; ok { - return fmt.Errorf("key %s already exist in the template map", k) - } - to.Resources[k] = v - } - - err = merge(to.Outputs, from.Outputs) - if err != nil { - return err - } - - return nil -} - -func checksum(data []byte) string { - sha := sha256.Sum256(data) - return base64.RawURLEncoding.EncodeToString(sha[:]) -} - -func zipResources() []bundle.Resource { - return []bundle.Resource{ - &bundle.LocalFile{Path: "pkg/functionbeat-aws", FileMode: 0755}, - } -} diff --git a/x-pack/functionbeat/manager/beater/functionbeat.go b/x-pack/functionbeat/manager/beater/functionbeat.go deleted file mode 100644 index b8e702860d0..00000000000 --- a/x-pack/functionbeat/manager/beater/functionbeat.go +++ /dev/null @@ -1,58 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package beater - -import ( - "fmt" - "time" - - "github.com/elastic/beats/v7/libbeat/beat" - "github.com/elastic/beats/v7/x-pack/functionbeat/config" - conf "github.com/elastic/elastic-agent-libs/config" - "github.com/elastic/elastic-agent-libs/logp" -) - -var ( - graceDelay = 45 * time.Minute - refreshDelay = 15 * time.Minute -) - -// Functionbeat is a beat designed to run under a serverless environment and listen to external triggers, -// each invocation will generate one or more events to Elasticsearch. -// -// Each serverless implementation is different but functionbeat follows a few execution rules. -// - Publishing events from the source to the output is done synchronously. -// - Execution can be suspended. -// - Run on a read only filesystem -// - More execution constraints based on speed and memory usage. -type Functionbeat struct { - log *logp.Logger - Config *config.Config -} - -// New creates an instance of functionbeat. -func New(b *beat.Beat, cfg *conf.C) (beat.Beater, error) { - c := &config.DefaultConfig - if err := cfg.Unpack(c); err != nil { - return nil, fmt.Errorf("error reading config file: %+v", err) - } - - bt := &Functionbeat{ - log: logp.NewLogger("functionbeat"), - Config: c, - } - return bt, nil -} - -// Run starts functionbeat. -func (bt *Functionbeat) Run(b *beat.Beat) error { - bt.log.Info("Functionbeat is running") - defer bt.log.Info("Functionbeat stopped running") - - return nil -} - -// Stop stops Functionbeat. -func (bt *Functionbeat) Stop() {} diff --git a/x-pack/functionbeat/manager/cmd/cli_handler.go b/x-pack/functionbeat/manager/cmd/cli_handler.go deleted file mode 100644 index 473f6b038f0..00000000000 --- a/x-pack/functionbeat/manager/cmd/cli_handler.go +++ /dev/null @@ -1,162 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package cmd - -import ( - "errors" - "fmt" - "io" - "strings" - - "github.com/elastic/beats/v7/x-pack/functionbeat/function/provider" - "github.com/elastic/elastic-agent-libs/logp" -) - -// Errors generated by the cliHandler. -var ( - errNoFunctionGiven = errors.New("no function given") -) - -// cliHandler takes a provider.CLIManager and acts a bridge between user enterred content from the CLI -// and the type managing the function on the provider. It allow to specify multiple functions at -// the command line but will do a single invocation on the CLIManager and will do general validation -// and normalization of the values. It also communicate the status of the operations to the user. -// -// NOTES: Each execution call of the CLIManager are independant, this mean that a fail call will not -// stop other calls to succeed. -// -// TODO(ph) functions could be merged into a single call , but I thought it was premature to do -// it. -type cliHandler struct { - clis map[string]provider.CLIManager - log *logp.Logger - errOutput io.Writer - output io.Writer - - functionsByProvider map[string]string -} - -func newCLIHandler(clis map[string]provider.CLIManager, functionsByProvider map[string]string, errOutput io.Writer, output io.Writer) *cliHandler { - return &cliHandler{ - clis: clis, - errOutput: errOutput, - functionsByProvider: functionsByProvider, - output: output, - log: logp.NewLogger("cli-handler"), - } -} - -func (c *cliHandler) Deploy(names []string) error { - c.log.Debugf("Starting deploy for: %s", strings.Join(names, ", ")) - defer c.log.Debug("Deploy execution ended") - - if len(names) == 0 { - return errNoFunctionGiven - } - - errCount := c.iterateCLIFuncVerbose(names, "deploy", provider.CLIManager.Deploy) - - if errCount > 0 { - return fmt.Errorf("Fail to deploy %d function(s)", errCount) - } - return nil -} - -func (c *cliHandler) Update(names []string) error { - c.log.Debugf("Starting update for: %s", strings.Join(names, ", ")) - defer c.log.Debug("Update execution ended") - - if len(names) == 0 { - return errNoFunctionGiven - } - - errCount := c.iterateCLIFuncVerbose(names, "update", provider.CLIManager.Update) - - if errCount > 0 { - return fmt.Errorf("fail to update %d function(s)", errCount) - } - return nil -} - -func (c *cliHandler) Remove(names []string) error { - c.log.Debugf("Starting remove for: %s", strings.Join(names, ", ")) - defer c.log.Debug("Remove execution ended") - - if len(names) == 0 { - return errNoFunctionGiven - } - - errCount := c.iterateCLIFuncVerbose(names, "remove", provider.CLIManager.Remove) - - if errCount > 0 { - return fmt.Errorf("fail to remove %d function(s)", errCount) - } - return nil -} - -func (c *cliHandler) Export(names []string) error { - c.log.Debugf("Starting export for: %s", strings.Join(names, ", ")) - defer c.log.Debug("Export execution ended") - - if len(names) == 0 { - return errNoFunctionGiven - } - - errCount := c.iterateCLIFuncQuiet(names, "export", provider.CLIManager.Export) - - if errCount > 0 { - return fmt.Errorf("fail to export %d function(s)", errCount) - } - return nil -} - -func (c *cliHandler) Package(outputPattern string) error { - for _, cli := range c.clis { - err := cli.Package(outputPattern) - if err != nil { - return err - } - } - return nil -} - -func (c *cliHandler) iterateCLIFuncVerbose(names []string, operation string, f func(provider.CLIManager, string) error) int { - return c.iterateCLIFunc(names, operation, f, true) -} - -func (c *cliHandler) iterateCLIFuncQuiet(names []string, operation string, f func(provider.CLIManager, string) error) int { - return c.iterateCLIFunc(names, operation, f, false) -} - -func (c *cliHandler) iterateCLIFunc(names []string, operation string, f func(provider.CLIManager, string) error, verbose bool) int { - errCount := 0 - for _, name := range names { - providerName, ok := c.functionsByProvider[name] - if !ok { - fmt.Fprintf(c.errOutput, "Function: %s, could not be %sed. Enable it.\n", name, operation) - errCount++ - continue - } - - cli, ok := c.clis[providerName] - if !ok { - fmt.Fprintf(c.errOutput, "Function: %s, could not be %s. Selected provider '%s' cannot be found", name, operation, providerName) - errCount++ - continue - } - - err := f(cli, name) - if err != nil { - fmt.Fprintf(c.errOutput, "Function: %s, could not %s, error: %s\n", name, operation, err) - errCount++ - continue - } - - if verbose { - fmt.Fprintf(c.output, "Function: %s, %s successful\n", name, operation) - } - } - return errCount -} diff --git a/x-pack/functionbeat/manager/cmd/cli_handler_test.go b/x-pack/functionbeat/manager/cmd/cli_handler_test.go deleted file mode 100644 index 726ee93e9a1..00000000000 --- a/x-pack/functionbeat/manager/cmd/cli_handler_test.go +++ /dev/null @@ -1,161 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package cmd - -import ( - "bytes" - "errors" - "io" - "testing" - - "github.com/stretchr/testify/assert" - "github.com/stretchr/testify/mock" - - "github.com/elastic/beats/v7/x-pack/functionbeat/function/provider" -) - -type mockCLIManager struct { - mock.Mock -} - -func (m *mockCLIManager) Deploy(name string) error { - args := m.Called(name) - return args.Error(0) -} - -func (m *mockCLIManager) Update(name string) error { - args := m.Called(name) - return args.Error(0) -} - -func (m *mockCLIManager) Remove(name string) error { - args := m.Called(name) - return args.Error(0) -} - -func (m *mockCLIManager) Export(name string) error { - args := m.Called(name) - return args.Error(0) -} - -func (m *mockCLIManager) Package(outputPattern string) error { - args := m.Called(outputPattern) - return args.Error(0) -} - -func outputs() (io.Writer, io.Writer) { - errOut := new(bytes.Buffer) - output := new(bytes.Buffer) - return errOut, output -} - -func functionByProvider() map[string]string { - return map[string]string{ - "super": "mockProvider", - "saiyajin": "mockProvider", - } -} - -func wrapCLIManager(m provider.CLIManager) map[string]provider.CLIManager { - return map[string]provider.CLIManager{ - "mockProvider": m, - } -} - -func TestCliHandler(t *testing.T) { - t.Run("deploy", testDeploy) - t.Run("update", testUpdate) - t.Run("remove", testRemove) -} - -func testDeploy(t *testing.T) { - t.Run("return error when no functions are specified", func(t *testing.T) { - errOut, output := outputs() - handler := newCLIHandler(wrapCLIManager(&mockCLIManager{}), functionByProvider(), errOut, output) - err := handler.Deploy([]string{}) - assert.Equal(t, errNoFunctionGiven, err) - }) - - t.Run("return an error if the manager return an error", func(t *testing.T) { - errOut, output := outputs() - myErr := errors.New("my error") - m := &mockCLIManager{} - m.On("Deploy", "saiyajin").Return(myErr) - handler := newCLIHandler(wrapCLIManager(m), functionByProvider(), errOut, output) - err := handler.Deploy([]string{"saiyajin"}) - assert.Error(t, err) - }) - - t.Run("call the method for all the functions", func(t *testing.T) { - errOut, output := outputs() - m := &mockCLIManager{} - m.On("Deploy", "super").Return(nil) - m.On("Deploy", "saiyajin").Return(nil) - handler := newCLIHandler(wrapCLIManager(m), functionByProvider(), errOut, output) - err := handler.Deploy([]string{"super", "saiyajin"}) - assert.NoError(t, err) - m.AssertExpectations(t) - }) -} - -func testUpdate(t *testing.T) { - t.Run("return error when no functions are specified", func(t *testing.T) { - errOut, output := outputs() - handler := newCLIHandler(wrapCLIManager(&mockCLIManager{}), functionByProvider(), errOut, output) - err := handler.Update([]string{}) - assert.Equal(t, errNoFunctionGiven, err) - }) - - t.Run("return an error if the manager return an error", func(t *testing.T) { - errOut, output := outputs() - myErr := errors.New("my error") - m := &mockCLIManager{} - m.On("Update", "saiyajin").Return(myErr) - handler := newCLIHandler(wrapCLIManager(m), functionByProvider(), errOut, output) - err := handler.Update([]string{"saiyajin"}) - assert.Error(t, err) - }) - - t.Run("call the method for all the functions", func(t *testing.T) { - errOut, output := outputs() - m := &mockCLIManager{} - m.On("Update", "super").Return(nil) - m.On("Update", "saiyajin").Return(nil) - handler := newCLIHandler(wrapCLIManager(m), functionByProvider(), errOut, output) - err := handler.Update([]string{"super", "saiyajin"}) - assert.NoError(t, err) - m.AssertExpectations(t) - }) -} - -func testRemove(t *testing.T) { - t.Run("return error when no functions are specified", func(t *testing.T) { - errOut, output := outputs() - handler := newCLIHandler(wrapCLIManager(&mockCLIManager{}), functionByProvider(), errOut, output) - err := handler.Remove([]string{}) - assert.Equal(t, errNoFunctionGiven, err) - }) - - t.Run("return an error if the manager return an error", func(t *testing.T) { - errOut, output := outputs() - myErr := errors.New("my error") - m := &mockCLIManager{} - m.On("Remove", "saiyajin").Return(myErr) - handler := newCLIHandler(wrapCLIManager(m), functionByProvider(), errOut, output) - err := handler.Remove([]string{"saiyajin"}) - assert.Error(t, err) - }) - - t.Run("call the method for all the functions", func(t *testing.T) { - errOut, output := outputs() - m := &mockCLIManager{} - m.On("Remove", "super").Return(nil) - m.On("Remove", "saiyajin").Return(nil) - handler := newCLIHandler(wrapCLIManager(m), functionByProvider(), errOut, output) - err := handler.Remove([]string{"super", "saiyajin"}) - assert.NoError(t, err) - m.AssertExpectations(t) - }) -} diff --git a/x-pack/functionbeat/manager/cmd/provider_cmd.go b/x-pack/functionbeat/manager/cmd/provider_cmd.go deleted file mode 100644 index 70c0637f108..00000000000 --- a/x-pack/functionbeat/manager/cmd/provider_cmd.go +++ /dev/null @@ -1,142 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package cmd - -import ( - "os" - "path/filepath" - - "github.com/spf13/cobra" - - "github.com/elastic/beats/v7/libbeat/cmd/instance" - "github.com/elastic/beats/v7/libbeat/common/cli" - "github.com/elastic/beats/v7/x-pack/functionbeat/config" - "github.com/elastic/beats/v7/x-pack/functionbeat/function/provider" -) - -func initProviders() ([]provider.Provider, error) { - b, err := instance.NewInitializedBeat(instance.Settings{ - Name: Name, - ConfigOverrides: config.Overrides, - }) - if err != nil { - return nil, err - } - - c, err := b.BeatConfig() - if err != nil { - return nil, err - } - - cfg := &config.DefaultConfig - if err := c.Unpack(cfg); err != nil { - return nil, err - } - - var providers []provider.Provider - for _, p := range cfg.Provider.GetFields() { - isAvailable, err := provider.IsAvailable(p) - if err != nil { - return nil, err - } - if !isAvailable { - continue - } - - providerCfg, err := cfg.Provider.Child(p, -1) - if err != nil { - return nil, err - } - provider, err := provider.NewProvider(p, providerCfg) - if err != nil { - return nil, err - } - providers = append(providers, provider) - } - - return providers, nil -} - -func handler() (*cliHandler, error) { - providers, err := initProviders() - if err != nil { - return nil, err - } - - clis := make(map[string]provider.CLIManager) - functionsByProvider := make(map[string]string) - for _, provider := range providers { - cli, err := provider.CLIManager() - if err != nil { - return nil, err - } - clis[provider.Name()] = cli - - enabledFunctions, err := provider.EnabledFunctions() - if err != nil { - return nil, err - } - - for _, f := range enabledFunctions { - functionsByProvider[f] = provider.Name() - } - } - return newCLIHandler(clis, functionsByProvider, os.Stdout, os.Stderr), nil -} - -func genCLICmd(use, short string, fn func(*cliHandler, []string) error) *cobra.Command { - return &cobra.Command{ - Use: use, - Short: short, - Run: cli.RunWith(func(_ *cobra.Command, args []string) error { - h, err := handler() - if err != nil { - return err - } - - return fn(h, args) - }), - } -} - -func genDeployCmd() *cobra.Command { - return genCLICmd("deploy", "Deploy a function", (*cliHandler).Deploy) -} - -func genUpdateCmd() *cobra.Command { - return genCLICmd("update", "Update a function", (*cliHandler).Update) -} - -func genRemoveCmd() *cobra.Command { - return genCLICmd("remove", "Remove a function", (*cliHandler).Remove) -} - -func genExportFunctionCmd() *cobra.Command { - return genCLICmd("function", "Export function template", (*cliHandler).Export) -} - -func genPackageCmd() *cobra.Command { - var outputPattern string - cmd := &cobra.Command{ - Use: "package", - Short: "Package the configuration and the executable in a zip", - Run: cli.RunWith(func(cmd *cobra.Command, args []string) error { - h, err := handler() - if err != nil { - return err - } - return h.Package(outputPattern) - }), - } - - dir, err := os.Getwd() - if err != nil { - panic(err) - } - - defaultOutput := filepath.Join(dir, "package-{{.Provider}}.zip") - cmd.Flags().StringVarP(&outputPattern, "output", "o", defaultOutput, "full path pattern to the package") - return cmd -} diff --git a/x-pack/functionbeat/manager/cmd/root.go b/x-pack/functionbeat/manager/cmd/root.go deleted file mode 100644 index fb44d45e331..00000000000 --- a/x-pack/functionbeat/manager/cmd/root.go +++ /dev/null @@ -1,50 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package cmd - -import ( - "os" - - "github.com/spf13/cobra" - - cmd "github.com/elastic/beats/v7/libbeat/cmd" - "github.com/elastic/beats/v7/libbeat/cmd/instance" - "github.com/elastic/beats/v7/x-pack/functionbeat/config" - "github.com/elastic/beats/v7/x-pack/functionbeat/manager/beater" -) - -// Name of this beat -var Name = "functionbeat" - -// RootCmd to handle functionbeat -var RootCmd *cmd.BeatsRootCmd - -func init() { - RootCmd = cmd.GenRootCmdWithSettings(beater.New, instance.Settings{ - Name: Name, - HasDashboards: false, - ConfigOverrides: config.Overrides, - ElasticLicensed: true, - }) - - RootCmd.RemoveCommand(RootCmd.RunCmd) - RootCmd.Run = func(_ *cobra.Command, _ []string) { - - RootCmd.Usage() - os.Exit(1) - } - - RootCmd.AddCommand(genDeployCmd()) - RootCmd.AddCommand(genUpdateCmd()) - RootCmd.AddCommand(genRemoveCmd()) - RootCmd.AddCommand(genPackageCmd()) - - addBeatSpecificSubcommands() -} - -func addBeatSpecificSubcommands() { - RootCmd.ExportCmd.Short = "Export current config, index template or function" - RootCmd.ExportCmd.AddCommand(genExportFunctionCmd()) -} diff --git a/x-pack/functionbeat/manager/core/bundle/bundle.go b/x-pack/functionbeat/manager/core/bundle/bundle.go deleted file mode 100644 index f034c4400f4..00000000000 --- a/x-pack/functionbeat/manager/core/bundle/bundle.go +++ /dev/null @@ -1,243 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package bundle - -import ( - "archive/zip" - "bufio" - "bytes" - "fmt" - "io" - "io/ioutil" - "os" - "path/filepath" -) - -// ReadCloserWith takes a reader and a closer for the specific reader and return an io.ReaderCloser. -func ReadCloserWith(reader io.Reader, closer io.Closer) io.ReadCloser { - return &ReadCloser{reader: reader, closer: closer} -} - -// ReadCloser wraps a io.Reader and a file handle into a FileReadCloser interface, -// this leave the responsability on the consumer to close the handle when its done consuming the -// io.Reader. -type ReadCloser struct { - reader io.Reader - closer io.Closer -} - -// Read proxies the Read to the original io.Reader. -func (f *ReadCloser) Read(p []byte) (int, error) { - return f.reader.Read(p) -} - -// Close closes the file handle this must be called after consuming the io.Reader to make sure we -// don't leak any file handle. -func (f *ReadCloser) Close() error { - return f.closer.Close() -} - -// Resource is the interface used to bundle the resource, a resource can be a local or a remote file. -// Reader must be a io.ReadCloser, this make it easier to deal with streaming of remote data. -type Resource interface { - // Open return an io.ReadCloser of the original resource, this will be used to stream content to - // The compressed file. - Open() (io.ReadCloser, error) - - // Name return the string that will be used as the file name inside the Zip file. - Name() string - - // Mode returns the permission of the file. - Mode() os.FileMode -} - -// Folder returns a list of files in a folder. -func Folder(folder, root string, filemode os.FileMode) []Resource { - resources := make([]Resource, 0) - err := filepath.Walk(folder, func(path string, info os.FileInfo, err error) error { - if err != nil { - return err - } - - if info.IsDir() { - return nil - } - - resources = append(resources, &RelativeFile{LocalFile{Path: path, FileMode: filemode}, root}) - - return nil - }) - - if err != nil { - return nil - } - - return resources -} - -// LocalFile represents a local file on disk. -type LocalFile struct { - Path string - FileMode os.FileMode -} - -// Open return a reader for the opened file. -func (l *LocalFile) Open() (io.ReadCloser, error) { - fd, err := os.Open(l.Path) - if err != nil { - return nil, err - } - - reader := bufio.NewReader(fd) - return ReadCloserWith(reader, fd), nil -} - -// Name return the basename of the file to be used as the name of the file in the archive. -func (l *LocalFile) Name() string { - return filepath.Base(l.Path) -} - -// Mode return the permissions of the file in the zip. -func (l *LocalFile) Mode() os.FileMode { - return l.FileMode -} - -// RelativeFile is a Localfile which needs to be placed relatively in the -// root of the bundle. -type RelativeFile struct { - LocalFile - root string -} - -// Name returns the name of the file. -func (r *RelativeFile) Name() string { - if r.root == "" { - return r.LocalFile.Path - } - return r.LocalFile.Path[len(r.root)+1:] -} - -// MemoryFile an in-memory representation of a physical file. -type MemoryFile struct { - Path string - FileMode os.FileMode - Raw []byte -} - -// Open the reader for the raw byte slice. -func (m *MemoryFile) Open() (io.ReadCloser, error) { - reader := bytes.NewReader(m.Raw) - return ioutil.NopCloser(reader), nil -} - -// Name returns the path to use in the zip. -func (m *MemoryFile) Name() string { - return m.Path -} - -// Mode returns the permission of the file. -func (m *MemoryFile) Mode() os.FileMode { - return m.FileMode -} - -// ZipBundle accepts a set of local files to bundle them into a zip file, it also accept size limits -// for the uncompressed and the compressed data. -type ZipBundle struct { - resources []Resource - maxSizeUncompressed int64 - maxSizeCompressed int64 -} - -// NewZipWithoutLimits creates a bundle that doesn't impose any limit on the uncompressed data and the -// compressed data. -func NewZipWithoutLimits(resources ...Resource) *ZipBundle { - return NewZipWithLimits(-1, -1, resources...) -} - -// NewZipWithLimits creates a Bundle that impose limit for the uncompressed data and the compressed data, -// using a limit of -1 with desactivate the check. -func NewZipWithLimits(maxSizeUncompressed, maxSizeCompressed int64, resources ...Resource) *ZipBundle { - return &ZipBundle{ - resources: resources, - maxSizeUncompressed: maxSizeUncompressed, - maxSizeCompressed: maxSizeCompressed, - } -} - -// Bytes takes the resources and bundle them into a zip and validates if needed that the -// created resources doesn't go over any predefined size limits. -func (p *ZipBundle) Bytes() ([]byte, error) { - buf := new(bytes.Buffer) - zipWriter := zip.NewWriter(buf) - - var uncompressed int64 - for _, file := range p.resources { - l, err := zipAddFile(zipWriter, file) - if err != nil { - return nil, err - } - - uncompressed = uncompressed + l - if p.maxSizeUncompressed != -1 && uncompressed > p.maxSizeUncompressed { - // Close the current zip, the zip has incomplete data. - zipWriter.Close() - return nil, fmt.Errorf( - "max uncompressed size reached, size %d, limit is %d", - uncompressed, - p.maxSizeUncompressed, - ) - } - - if l == 0 { - continue - } - - // Force a flush to accurately check for the size of the bytes.Buffer and see if - // we are over the limit. - if err := zipWriter.Flush(); err != nil { - return nil, err - } - - if p.maxSizeCompressed != -1 && int64(buf.Len()) > p.maxSizeCompressed { - // Close the current zip, the zip has incomplete data. - zipWriter.Close() - return nil, fmt.Errorf( - "max compressed size reached, size %d, limit is %d", - buf.Len(), - p.maxSizeCompressed, - ) - } - } - - // Flush bytes/writes headers, the zip is valid at this point. - zipWriter.Close() - return buf.Bytes(), nil -} - -func zipAddFile(zipWriter *zip.Writer, r Resource) (int64, error) { - f, err := r.Open() - if err != nil { - return 0, err - } - defer f.Close() - - header := &zip.FileHeader{ - Name: r.Name(), - Method: zip.Deflate, - } - - header.SetMode(r.Mode()) - w, err := zipWriter.CreateHeader(header) - if err != nil { - return 0, err - } - - l, err := io.Copy(w, f) - if err != nil { - return 0, err - } - - return l, nil -} diff --git a/x-pack/functionbeat/manager/core/bundle/bundle_test.go b/x-pack/functionbeat/manager/core/bundle/bundle_test.go deleted file mode 100644 index 89d010522b7..00000000000 --- a/x-pack/functionbeat/manager/core/bundle/bundle_test.go +++ /dev/null @@ -1,150 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package bundle - -import ( - "archive/zip" - "bytes" - "io/ioutil" - "os" - "testing" - - "github.com/stretchr/testify/assert" - - "github.com/elastic/beats/v7/libbeat/common" -) - -func newFixedResource(name string, length int64) *MemoryFile { - paddingData, err := common.RandomBytes(int(length)) - if err != nil { - // fatal, This mean something is wrong with the random number generator. - panic(err) - } - return &MemoryFile{Path: name, Raw: paddingData, FileMode: 0755} -} - -func TestZipBundle(t *testing.T) { - t.Run("with limits", testWithLimits) - t.Run("with no limits", testArtifact(-1, -1)) -} - -func testWithLimits(t *testing.T) { - t.Run("uncompressed size is over limit", func(t *testing.T) { - limit := int64(50) - bundle := NewZipWithLimits(limit, -1, newFixedResource("ok.yml", limit+1)) - _, err := bundle.Bytes() - assert.Error(t, err) - }) - - t.Run("compressed size is over limit", func(t *testing.T) { - limit := int64(10) - bundle := NewZipWithLimits(-1, limit, newFixedResource("ok.yml", 2*limit)) - _, err := bundle.Bytes() - assert.Error(t, err) - }) - - t.Run("zip artifact is under limit and valid", testArtifact(1000, 1000)) -} - -func testArtifact(maxSizeUncompressed, maxSizeCompressed int64) func(t *testing.T) { - return func(t *testing.T) { - m := map[string]*MemoryFile{ - "f1.txt": newFixedResource("f1.txt", 65), - "f2.txt": newFixedResource("f2.txt", 100), - } - - resources := make([]Resource, len(m)) - var idx int - for _, r := range m { - resources[idx] = r - idx++ - } - - bundle := NewZipWithLimits(maxSizeUncompressed, maxSizeCompressed, resources...) - b, err := bundle.Bytes() - if !assert.NoError(t, err) { - return - } - - zip, err := zip.NewReader(bytes.NewReader(b), int64(len(b))) - if !assert.NoError(t, err) { - return - } - - if !assert.Equal(t, 2, len(zip.File)) { - return - } - - for _, file := range zip.File { - r, ok := m[file.Name] - if !assert.True(t, ok) { - t.Fatal("unknown file present in the zip") - } - - reader, err := file.Open() - if !assert.NoError(t, err) { - return - } - defer reader.Close() - - raw, err := ioutil.ReadAll(reader) - if !assert.NoError(t, err) { - return - } - - assert.True(t, bytes.Equal(r.Raw, raw), "bytes doesn't match") - } - } -} - -func TestLocalFile(t *testing.T) { - local := LocalFile{Path: "testdata/lipsum.txt", FileMode: 755} - - assert.Equal(t, "lipsum.txt", local.Name()) - assert.Equal(t, os.FileMode(755), local.Mode()) - - reader, err := local.Open() - if !assert.NoError(t, err) { - return - } - - defer func() { - err := reader.Close() - assert.NoError(t, err) - }() - - content, err := ioutil.ReadAll(reader) - if !assert.NoError(t, err) { - return - } - - raw, _ := ioutil.ReadFile("testdata/lipsum.txt") - assert.Equal(t, raw, content) -} - -func TestMemoryFile(t *testing.T) { - raw := []byte("hello world") - memory := MemoryFile{Path: "lipsum.txt", FileMode: 755, Raw: raw} - - assert.Equal(t, "lipsum.txt", memory.Name()) - assert.Equal(t, os.FileMode(755), memory.Mode()) - - reader, err := memory.Open() - if !assert.NoError(t, err) { - return - } - - defer func() { - err := reader.Close() - assert.NoError(t, err) - }() - - content, err := ioutil.ReadAll(reader) - if !assert.NoError(t, err) { - return - } - - assert.Equal(t, raw, content) -} diff --git a/x-pack/functionbeat/manager/core/bundle/testdata/lipsum.txt b/x-pack/functionbeat/manager/core/bundle/testdata/lipsum.txt deleted file mode 100644 index d86bac9de59..00000000000 --- a/x-pack/functionbeat/manager/core/bundle/testdata/lipsum.txt +++ /dev/null @@ -1 +0,0 @@ -OK diff --git a/x-pack/functionbeat/manager/core/makezip.go b/x-pack/functionbeat/manager/core/makezip.go deleted file mode 100644 index 6f5c2c2d530..00000000000 --- a/x-pack/functionbeat/manager/core/makezip.go +++ /dev/null @@ -1,115 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package core - -import ( - "fmt" - - yaml "gopkg.in/yaml.v2" - - "github.com/elastic/beats/v7/libbeat/cfgfile" - "github.com/elastic/beats/v7/libbeat/cmd/instance" - "github.com/elastic/beats/v7/x-pack/functionbeat/config" - "github.com/elastic/beats/v7/x-pack/functionbeat/manager/core/bundle" - "github.com/elastic/elastic-agent-libs/keystore" -) - -func rawYaml() ([]byte, error) { - // Load the configuration file from disk with all the settings, - // the function takes care of using -c. - rawConfig, err := cfgfile.Load("", config.Overrides) - if err != nil { - return nil, err - } - var config map[string]interface{} - if err := rawConfig.Unpack(&config); err != nil { - return nil, err - } - - res, err := yaml.Marshal(config) - if err != nil { - return nil, err - } - - return res, nil -} - -// MakeZip creates a zip from the the current artifacts and the currently available configuration. -func MakeZip( - packageUncompressedLimit int64, - packageCompressedLimit int64, - providerResources []bundle.Resource, -) ([]byte, error) { - if len(providerResources) == 0 { - return nil, fmt.Errorf("no provider specific resources are set") - } - - rawConfig, err := rawYaml() - if err != nil { - return nil, err - } - - resources := append( - providerResources, - &bundle.MemoryFile{Path: "functionbeat.yml", Raw: rawConfig, FileMode: 0766}, - ) - - resources, err = addKeystoreIfConfigured(resources) - if err != nil { - return nil, err - } - - bundle := bundle.NewZipWithLimits( - packageUncompressedLimit, - packageCompressedLimit, - resources...) - - content, err := bundle.Bytes() - if err != nil { - return nil, err - } - return content, nil -} - -func addKeystoreIfConfigured(resources []bundle.Resource) ([]bundle.Resource, error) { - ksPackager, err := keystorePackager() - if err != nil { - return nil, err - } - - rawKeystore, err := ksPackager.Package() - if err != nil { - return nil, err - } - - if len(rawKeystore) > 0 { - resources = append(resources, &bundle.MemoryFile{ - Path: ksPackager.ConfiguredPath(), - Raw: rawKeystore, - FileMode: 0600, - }) - } - - return resources, nil -} - -func keystorePackager() (keystore.Packager, error) { - cfg, err := cfgfile.Load("", config.Overrides) - if err != nil { - return nil, fmt.Errorf("error loading config file: %v", err) - } - - store, err := instance.LoadKeystore(cfg, "functionbeat") - if err != nil { - return nil, fmt.Errorf("cannot load the keystore for packaging: %w", err) - } - - packager, ok := store.(keystore.Packager) - if !ok { - return nil, fmt.Errorf("the configured keystore cannot be packaged") - } - - return packager, nil -} diff --git a/x-pack/functionbeat/manager/executor/executor.go b/x-pack/functionbeat/manager/executor/executor.go deleted file mode 100644 index 75de2d776b1..00000000000 --- a/x-pack/functionbeat/manager/executor/executor.go +++ /dev/null @@ -1,112 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package executor - -import ( - "errors" - - "github.com/elastic/elastic-agent-libs/logp" -) - -var ( - // ErrNeverRun is returned if the step was never run. - ErrNeverRun = errors.New("executor was never executed") - // ErrCannotAdd is returned if the executor had already ran and a new operation is added. - ErrCannotAdd = errors.New("cannot add to an already executed executor") - // ErrAlreadyExecuted is returned if it has already run. - ErrAlreadyExecuted = errors.New("executor already executed") -) - -// Context holds the information of each execution step. -type Context interface{} - -// Executor tries to execute operations. If an operation fails, everything is rolled back. -type Executor struct { - operations []doer - undos []undoer - completed bool - log *logp.Logger -} - -type doer interface { - Execute(Context) error -} - -type undoer interface { - Rollback(Context) error -} - -// NewExecutor return a new executor. -func NewExecutor(log *logp.Logger) *Executor { - if log == nil { - log = logp.NewLogger("") - } - - log = log.Named("executor") - return &Executor{log: log} -} - -// Execute executes all operations. If something fail it rolls back. -func (e *Executor) Execute(ctx Context) (err error) { - e.log.Debugf("The executor is executing '%d' operations for converging state", len(e.operations)) - if e.IsCompleted() { - return ErrAlreadyExecuted - } - for _, operation := range e.operations { - err = operation.Execute(ctx) - if err != nil { - break - } - v, ok := operation.(undoer) - if ok { - e.undos = append(e.undos, v) - } - } - if err == nil { - e.log.Debug("All operations successful") - } - e.markCompleted() - return err -} - -// Rollback rolls back executed operations. -func (e *Executor) Rollback(ctx Context) (err error) { - e.log.Debugf("The executor is rolling back previous execution, '%d' operations to rollback", len(e.undos)) - if !e.IsCompleted() { - return ErrNeverRun - } - for i := len(e.undos) - 1; i >= 0; i-- { - operation := e.undos[i] - err = operation.Rollback(ctx) - if err != nil { - break - } - } - - if err == nil { - e.log.Debug("The rollback is successful") - } else { - e.log.Debug("The rollback is incomplete") - } - return err -} - -// Add adds new operation to execute. -func (e *Executor) Add(operation ...doer) error { - if e.IsCompleted() { - return ErrCannotAdd - } - e.operations = append(e.operations, operation...) - return nil -} - -func (e *Executor) markCompleted() { - e.completed = true -} - -// IsCompleted returns if all operations are completed. -func (e *Executor) IsCompleted() bool { - return e.completed -} diff --git a/x-pack/functionbeat/manager/executor/executor_test.go b/x-pack/functionbeat/manager/executor/executor_test.go deleted file mode 100644 index 024ef79af1d..00000000000 --- a/x-pack/functionbeat/manager/executor/executor_test.go +++ /dev/null @@ -1,181 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package executor - -import ( - "errors" - "testing" - - "github.com/stretchr/testify/assert" - "github.com/stretchr/testify/mock" -) - -type MockUndoer struct { - mock.Mock -} - -func (m *MockUndoer) Execute(_ Context) error { - args := m.Called() - return args.Error(0) -} - -func (m *MockUndoer) Rollback(_ Context) error { - args := m.Called() - return args.Error(0) -} - -type MockDoer struct { - mock.Mock -} - -func (m *MockDoer) Execute(_ Context) error { - args := m.Called() - return args.Error(0) -} - -func TestExecutor(t *testing.T) { - t.Run("executes all the tasks", testAll) - t.Run("stop execution on first error", testError) - t.Run("stop execution and allow rollback on undoer", testUndoer) - t.Run("stop rollback if one rollback fail", testFailRollback) - t.Run("an execution cannot be run twice", testCannotRunTwice) - t.Run("cannot add operation to a completed execution", testCannotAddCompleted) -} - -func testAll(t *testing.T) { - ctx := struct{}{} - executor := NewExecutor(nil) - m1 := &MockDoer{} - m1.On("Execute").Return(nil) - - m2 := &MockDoer{} - m2.On("Execute").Return(nil) - - executor.Add(m1, m2) - err := executor.Execute(ctx) - if !assert.NoError(t, err) { - return - } - - m1.AssertExpectations(t) - m2.AssertExpectations(t) -} - -func testError(t *testing.T) { - ctx := struct{}{} - executor := NewExecutor(nil) - m1 := &MockDoer{} - m1.On("Execute").Return(nil) - - m2 := &MockDoer{} - e := errors.New("something bad") - m2.On("Execute").Return(e) - - m3 := &MockDoer{} - executor.Add(m1, m2, m3) - err := executor.Execute(ctx) - if assert.Equal(t, e, err) { - return - } - - m1.AssertExpectations(t) - m2.AssertExpectations(t) - m3.AssertExpectations(t) -} - -func testUndoer(t *testing.T) { - ctx := struct{}{} - executor := NewExecutor(nil) - m1 := &MockUndoer{} - m1.On("Execute").Return(nil) - m1.On("Rollback").Return(nil) - - m2 := &MockDoer{} - e := errors.New("something bad") - m2.On("Execute").Return(e) - - m3 := &MockDoer{} - executor.Add(m1, m2, m3) - err := executor.Execute(ctx) - if !assert.Equal(t, e, err) { - return - } - - err = executor.Rollback(ctx) - if !assert.NoError(t, err) { - return - } - - m1.AssertExpectations(t) - m2.AssertExpectations(t) - m3.AssertExpectations(t) -} - -func testFailRollback(t *testing.T) { - ctx := struct{}{} - e := errors.New("error on execution") - e2 := errors.New("error on rollback") - - executor := NewExecutor(nil) - m1 := &MockUndoer{} - m1.On("Execute").Return(nil) - - m2 := &MockUndoer{} - m2.On("Execute").Return(nil) - m2.On("Rollback").Return(e2) - - m3 := &MockUndoer{} - m3.On("Execute").Return(e) - - executor.Add(m1, m2, m3) - - err := executor.Execute(ctx) - if !assert.Equal(t, e, err) { - return - } - - err = executor.Rollback(ctx) - if !assert.Error(t, err) { - return - } - - m1.AssertExpectations(t) - m2.AssertExpectations(t) - m3.AssertExpectations(t) -} - -func testCannotRunTwice(t *testing.T) { - ctx := struct{}{} - executor := NewExecutor(nil) - m1 := &MockDoer{} - m1.On("Execute").Return(nil) - - executor.Add(m1) - err := executor.Execute(ctx) - if !assert.NoError(t, err) { - return - } - - m1.AssertExpectations(t) - - assert.True(t, executor.IsCompleted()) - assert.Error(t, ErrAlreadyExecuted, executor.Execute(ctx)) -} - -func testCannotAddCompleted(t *testing.T) { - executor := NewExecutor(nil) - m1 := &MockDoer{} - m1.On("Execute").Return(nil) - - executor.Add(m1) - err := executor.Execute(struct{}{}) - if !assert.NoError(t, err) { - return - } - - m1.AssertExpectations(t) - - assert.Error(t, executor.Add(&MockDoer{})) -} diff --git a/x-pack/functionbeat/provider/aws/aws/api_gateway_proxy.go b/x-pack/functionbeat/provider/aws/aws/api_gateway_proxy.go deleted file mode 100644 index 5b9cd9734a5..00000000000 --- a/x-pack/functionbeat/provider/aws/aws/api_gateway_proxy.go +++ /dev/null @@ -1,96 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package aws - -import ( - "context" - "encoding/json" - "net/http" - - "github.com/aws/aws-lambda-go/events" - "github.com/aws/aws-lambda-go/lambda" - - "github.com/elastic/beats/v7/libbeat/common/cfgwarn" - "github.com/elastic/beats/v7/libbeat/feature" - "github.com/elastic/beats/v7/libbeat/publisher/pipeline" - "github.com/elastic/beats/v7/x-pack/functionbeat/function/provider" - "github.com/elastic/beats/v7/x-pack/functionbeat/function/telemetry" - "github.com/elastic/beats/v7/x-pack/functionbeat/provider/aws/aws/transformer" - conf "github.com/elastic/elastic-agent-libs/config" - "github.com/elastic/elastic-agent-libs/logp" -) - -type message struct { - RequestID string `json:"request_id"` - Status int `json:"status"` - Message string `json:"message"` -} - -// APIGatewayProxy receives events from the web service and forward them to elasticsearch. -type APIGatewayProxy struct { - log *logp.Logger -} - -// NewAPIGatewayProxy creates a new function to receives events from the web api gateway. -func NewAPIGatewayProxy(provider provider.Provider, config *conf.C) (provider.Function, error) { - cfgwarn.Experimental("The api_gateway_proxy trigger is experimental.") - return &APIGatewayProxy{log: logp.NewLogger("api gateway proxy")}, nil -} - -// APIGatewayProxyDetails returns the details of the feature. -func APIGatewayProxyDetails() feature.Details { - return feature.MakeDetails("API Gateway proxy trigger", "receive events from the api gateway proxy", feature.Experimental) -} - -// Run starts the lambda function and wait for web triggers. -func (a *APIGatewayProxy) Run(_ context.Context, client pipeline.ISyncClient, telemetry telemetry.T) error { - telemetry.AddTriggeredFunction() - - lambda.Start(a.createHandler(client)) - return nil -} - -func (a *APIGatewayProxy) createHandler( - client pipeline.ISyncClient, -) func(request events.APIGatewayProxyRequest) (events.APIGatewayProxyResponse, error) { - return func(request events.APIGatewayProxyRequest) (events.APIGatewayProxyResponse, error) { - a.log.Debugf("The handler receives a new event from the gateway (requestID: %s)", request.RequestContext.RequestID) - event := transformer.APIGatewayProxyRequest(request) - - if err := client.Publish(event); err != nil { - a.log.Errorf("could not publish event to the pipeline, error: %+v", err) - return buildResponse( - http.StatusInternalServerError, - "an error occurred when sending the event.", - request.RequestContext.RequestID, - ), err - } - client.Wait() - return buildResponse( - http.StatusOK, - "event received successfully.", - request.RequestContext.RequestID, - ), nil - } -} - -func buildResponse( - statusCode int, - responseMsg string, - requestID string, -) events.APIGatewayProxyResponse { - body, _ := json.Marshal(message{Status: statusCode, Message: responseMsg, RequestID: requestID}) - - return events.APIGatewayProxyResponse{ - StatusCode: statusCode, - Headers: map[string]string{"Content-Type": "application/json"}, - Body: string(body), - } -} - -// Name return the name of the lambda function. -func (a *APIGatewayProxy) Name() string { - return "api_gateway_proxy" -} diff --git a/x-pack/functionbeat/provider/aws/aws/api_gateway_proxy_test.go b/x-pack/functionbeat/provider/aws/aws/api_gateway_proxy_test.go deleted file mode 100644 index 640dc949e0c..00000000000 --- a/x-pack/functionbeat/provider/aws/aws/api_gateway_proxy_test.go +++ /dev/null @@ -1,92 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package aws - -import ( - "encoding/json" - "errors" - "net/http" - "testing" - - "github.com/aws/aws-lambda-go/events" - "github.com/stretchr/testify/assert" - - "github.com/elastic/beats/v7/x-pack/functionbeat/function/provider" - conf "github.com/elastic/elastic-agent-libs/config" -) - -func TestAPIGatewayProxy(t *testing.T) { - cfg := conf.MustNewConfigFrom(map[string]interface{}{ - "name": "foobar", - }) - - t.Run("when publish is succesful", func(t *testing.T) { - t.SkipNow() - client := &arrayBackedClient{} - s, err := NewAPIGatewayProxy(&provider.DefaultProvider{}, cfg) - if !assert.NoError(t, err) { - return - } - - c, _ := s.(*APIGatewayProxy) - handler := c.createHandler(client) - res, err := handler(generateAPIGatewayProxyEvent()) - assert.NoError(t, err) - assert.Equal(t, res.StatusCode, http.StatusOK) - ty, _ := res.Headers["Content-Type"] - assert.Equal(t, "application/json", ty) - - message, err := unserializeResponse(res.Body) - if !assert.NoError(t, err) { - return - } - - assert.Equal(t, "1234", message.RequestID) - assert.Equal(t, "event received successfully.", message.Message) - assert.Equal(t, http.StatusOK, message.Status) - }) - - t.Run("when publish is not succesful", func(t *testing.T) { - e := errors.New("something bad") - client := &arrayBackedClient{err: e} - - s, err := NewAPIGatewayProxy(&provider.DefaultProvider{}, cfg) - if !assert.NoError(t, err) { - return - } - - c, _ := s.(*APIGatewayProxy) - res, err := c.createHandler(client)(generateAPIGatewayProxyEvent()) - assert.Equal(t, e, err) - assert.Equal(t, http.StatusInternalServerError, res.StatusCode) - ty, _ := res.Headers["Content-Type"] - assert.Equal(t, "application/json", ty) - - message, err := unserializeResponse(res.Body) - if !assert.NoError(t, err) { - return - } - - assert.Equal(t, "1234", message.RequestID) - assert.Equal(t, "an error occurred when sending the event.", message.Message) - assert.Equal(t, http.StatusInternalServerError, message.Status) - }) -} - -func generateAPIGatewayProxyEvent() events.APIGatewayProxyRequest { - return events.APIGatewayProxyRequest{ - RequestContext: events.APIGatewayProxyRequestContext{ - RequestID: "1234", - }, - } -} - -func unserializeResponse(raw string) (*message, error) { - message := &message{} - if err := json.Unmarshal([]byte(raw), message); err != nil { - return nil, err - } - return message, nil -} diff --git a/x-pack/functionbeat/provider/aws/aws/cloudwatch_kinesis.go b/x-pack/functionbeat/provider/aws/aws/cloudwatch_kinesis.go deleted file mode 100644 index adde8793ec5..00000000000 --- a/x-pack/functionbeat/provider/aws/aws/cloudwatch_kinesis.go +++ /dev/null @@ -1,117 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package aws - -import ( - "context" - - "github.com/aws/aws-lambda-go/events" - lambdarunner "github.com/aws/aws-lambda-go/lambda" - "github.com/awslabs/goformation/v7/cloudformation" - "github.com/awslabs/goformation/v7/cloudformation/iam" - - "github.com/elastic/beats/v7/libbeat/feature" - "github.com/elastic/beats/v7/libbeat/publisher/pipeline" - "github.com/elastic/beats/v7/x-pack/functionbeat/function/provider" - "github.com/elastic/beats/v7/x-pack/functionbeat/function/telemetry" - "github.com/elastic/beats/v7/x-pack/functionbeat/provider/aws/aws/transformer" - conf "github.com/elastic/elastic-agent-libs/config" - "github.com/elastic/elastic-agent-libs/logp" -) - -// CloudwatchKinesis receives events from a kinesis stream and forward them to elasticsearch. -type CloudwatchKinesis struct { - *Kinesis - log *logp.Logger - config *CloudwatchKinesisConfig -} - -// CloudwatchKinesisConfig stores the configuration of Kinesis and additional options on decompressing data. -type CloudwatchKinesisConfig struct { - *KinesisConfig `config:",inline"` - Base64Encoded bool `config:"base64_encoded"` - Compressed bool `config:"compressed"` -} - -// NewCloudwatchKinesis creates a new function to receives events from a kinesis stream. -func NewCloudwatchKinesis(provider provider.Provider, cfg *conf.C) (provider.Function, error) { - config := defaultCloudwatchKinesisConfig() - if err := cfg.Unpack(config); err != nil { - return nil, err - } - - logger := logp.NewLogger("cloudwatch_logs_kinesis") - - return &CloudwatchKinesis{ - Kinesis: &Kinesis{ - config: config.KinesisConfig, - log: logger, - }, - log: logger, - config: config, - }, nil -} - -func defaultCloudwatchKinesisConfig() *CloudwatchKinesisConfig { - return &CloudwatchKinesisConfig{ - &KinesisConfig{ - LambdaConfig: DefaultLambdaConfig, - }, - false, - true, - } -} - -// CloudwatchKinesisDetails returns the details of the feature. -func CloudwatchKinesisDetails() feature.Details { - return feature.MakeDetails("Cloudwatch logs via Kinesis trigger", "receive Cloudwatch logs from a Kinesis stream", feature.Experimental) -} - -// Run starts the lambda function and wait for web triggers. -func (c *CloudwatchKinesis) Run(_ context.Context, client pipeline.ISyncClient, t telemetry.T) error { - t.AddTriggeredFunction() - - lambdarunner.Start(c.createHandler(client)) - return nil -} - -func (c *CloudwatchKinesis) createHandler(client pipeline.ISyncClient) func(request events.KinesisEvent) error { - return func(request events.KinesisEvent) error { - c.log.Debugf("The handler receives %d events", len(request.Records)) - - events, err := transformer.CloudwatchKinesisEvent(request, c.config.Base64Encoded, c.config.Compressed) - if err != nil { - return err - } - - if err := client.PublishAll(events); err != nil { - c.log.Errorf("Could not publish events to the pipeline, error: %+v", err) - return err - } - client.Wait() - return nil - } -} - -// Name return the name of the lambda function. -func (c *CloudwatchKinesis) Name() string { - return "cloudwatch_logs_kinesis" -} - -// LambdaConfig returns the configuration to use when creating the lambda. -func (c *CloudwatchKinesis) LambdaConfig() *LambdaConfig { - return c.config.LambdaConfig -} - -// Template returns the cloudformation template for configuring the service with the specified -// triggers. -func (c *CloudwatchKinesis) Template() *cloudformation.Template { - return c.Kinesis.Template() -} - -// Policies returns a slice of policy to add to the lambda role. -func (c *CloudwatchKinesis) Policies() []iam.Role_Policy { - return c.Kinesis.Policies() -} diff --git a/x-pack/functionbeat/provider/aws/aws/cloudwatch_logs.go b/x-pack/functionbeat/provider/aws/aws/cloudwatch_logs.go deleted file mode 100644 index 83f8f011704..00000000000 --- a/x-pack/functionbeat/provider/aws/aws/cloudwatch_logs.go +++ /dev/null @@ -1,230 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package aws - -import ( - "context" - "encoding/json" - "errors" - "fmt" - "regexp" - "strconv" - - "github.com/aws/aws-lambda-go/events" - lambdarunner "github.com/aws/aws-lambda-go/lambda" - "github.com/awslabs/goformation/v7/cloudformation" - "github.com/awslabs/goformation/v7/cloudformation/iam" - "github.com/awslabs/goformation/v7/cloudformation/lambda" - "github.com/awslabs/goformation/v7/cloudformation/policies" - - "github.com/elastic/beats/v7/libbeat/feature" - "github.com/elastic/beats/v7/libbeat/publisher/pipeline" - "github.com/elastic/beats/v7/x-pack/functionbeat/function/provider" - "github.com/elastic/beats/v7/x-pack/functionbeat/function/telemetry" - "github.com/elastic/beats/v7/x-pack/functionbeat/provider/aws/aws/transformer" - conf "github.com/elastic/elastic-agent-libs/config" - "github.com/elastic/elastic-agent-libs/logp" -) - -var ( - logGroupNamePattern = "^[\\.\\-_/#A-Za-z0-9]+$" - logGroupNameRE = regexp.MustCompile(logGroupNamePattern) -) - -// CloudwatchLogsConfig is the configuration for the cloudwatchlogs event type. -type CloudwatchLogsConfig struct { - Triggers []*CloudwatchLogsTriggerConfig `config:"triggers"` - Description string `config:"description"` - Name string `config:"name" validate:"nonzero,required"` - LambdaConfig *LambdaConfig `config:",inline"` -} - -// CloudwatchLogsTriggerConfig is the configuration for the specific triggers for cloudwatch. -type CloudwatchLogsTriggerConfig struct { - LogGroupName logGroupName `config:"log_group_name" validate:"nonzero,required"` - FilterPattern string `config:"filter_pattern"` -} - -// Validate validates the configuration. -func (cfg *CloudwatchLogsConfig) Validate() error { - if len(cfg.Triggers) == 0 { - return errors.New("you need to specify at least one trigger") - } - return nil -} - -// DOC: see validations rules at https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateLogGroup.html -type logGroupName string - -// Unpack takes a string and validate the log group format. -func (l *logGroupName) Unpack(s string) error { - const max = 512 - const min = 1 - - if len(s) > max { - return fmt.Errorf("log group name '%s' is too long, maximum length is %d", s, max) - } - - if len(s) < min { - return fmt.Errorf("log group name too short, minimum length is %d", min) - } - - if !logGroupNameRE.MatchString(s) { - return fmt.Errorf( - "invalid characters in log group name '%s', name must match regular expression: '%s'", - s, - logGroupNamePattern, - ) - } - *l = logGroupName(s) - return nil -} - -// CloudwatchLogs receives CloudwatchLogs events from a lambda function and forward the logs to -// an Elasticsearch cluster. -type CloudwatchLogs struct { - log *logp.Logger - config *CloudwatchLogsConfig -} - -// NewCloudwatchLogs create a new function to listen to cloudwatch logs events. -func NewCloudwatchLogs(provider provider.Provider, cfg *conf.C) (provider.Function, error) { - config := &CloudwatchLogsConfig{ - LambdaConfig: DefaultLambdaConfig, - } - if err := cfg.Unpack(config); err != nil { - return nil, err - } - return &CloudwatchLogs{log: logp.NewLogger("cloudwatch_logs"), config: config}, nil -} - -// CloudwatchLogsDetails returns the details of the feature. -func CloudwatchLogsDetails() feature.Details { - return feature.MakeDetails("Cloudwatch Logs trigger", "receive events from cloudwatch logs.", feature.Stable) -} - -// Run start the AWS lambda handles and will transform any events received to the pipeline. -func (c *CloudwatchLogs) Run(_ context.Context, client pipeline.ISyncClient, t telemetry.T) error { - t.AddTriggeredFunction() - - lambdarunner.Start(c.createHandler(client)) - return nil -} - -func (c *CloudwatchLogs) createHandler( - client pipeline.ISyncClient, -) func(request events.CloudwatchLogsEvent) error { - return func(request events.CloudwatchLogsEvent) error { - parsedEvent, err := request.AWSLogs.Parse() - if err != nil { - c.log.Errorf("Could not parse events from cloudwatch logs, error: %+v", err) - return err - } - - c.log.Debugf( - "The handler receives %d events (logStream: %s, owner: %s, logGroup: %s, messageType: %s)", - len(parsedEvent.LogEvents), - parsedEvent.LogStream, - parsedEvent.Owner, - parsedEvent.LogGroup, - parsedEvent.MessageType, - ) - - events := transformer.CloudwatchLogs(parsedEvent) - - if err := client.PublishAll(events); err != nil { - c.log.Errorf("Could not publish events to the pipeline, error: %+v", err) - return err - } - client.Wait() - return nil - } -} - -// Name returns the name of the function. -func (c CloudwatchLogs) Name() string { - return "cloudwatch_logs" -} - -// AWSLogsSubscriptionFilter overrides the type from goformation to allow to pass an empty string. -// The API support an empty string, but requires one, the original type does not permit that. -type AWSLogsSubscriptionFilter struct { - DestinationArn string `json:"DestinationArn,omitempty"` - FilterPattern string `json:"FilterPattern"` - LogGroupName string `json:"LogGroupName,omitempty"` -} - -// MarshalJSON is a custom JSON marshalling hook that embeds this object into -// an AWS CloudFormation JSON resource's 'Properties' field and adds a 'Type'. -func (r AWSLogsSubscriptionFilter) MarshalJSON() ([]byte, error) { - type Properties AWSLogsSubscriptionFilter - return json.Marshal(&struct { - Type string - Properties Properties - DeletionPolicy policies.DeletionPolicy `json:"DeletionPolicy,omitempty"` - }{ - Type: r.AWSCloudFormationType(), - Properties: (Properties)(r), - }) -} - -// AWSCloudFormationType return the AWS type. -func (r *AWSLogsSubscriptionFilter) AWSCloudFormationType() string { - return "AWS::Logs::SubscriptionFilter" -} - -// Template returns the cloudformation template for configuring the service with the specified triggers. -func (c *CloudwatchLogs) Template() *cloudformation.Template { - prefix := func(suffix string) string { - return NormalizeResourceName("fnb" + c.config.Name + suffix) - } - - template := cloudformation.NewTemplate() - for idx, trigger := range c.config.Triggers { - // doc: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html - template.Resources[prefix("Permission"+strconv.Itoa(idx))] = &lambda.Permission{ - Action: "lambda:InvokeFunction", - FunctionName: cloudformation.GetAtt(prefix(""), "Arn"), - Principal: cloudformation.Join("", []string{ - "logs.", - cloudformation.Ref("AWS::Region"), // Use the configuration region. - ".", - cloudformation.Ref("AWS::URLSuffix"), // awsamazon.com or .com.ch - }), - SourceArn: cloudformation.JoinPtr( - "", - []string{ - "arn:", - cloudformation.Ref("AWS::Partition"), - ":logs:", - cloudformation.Ref("AWS::Region"), - ":", - cloudformation.Ref("AWS::AccountId"), - ":log-group:", - string(trigger.LogGroupName), - ":*", - }, - ), - } - - // doc: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-logs-subscriptionfilter.html - template.Resources[prefix("SF")+NormalizeResourceName(string(trigger.LogGroupName))] = &AWSLogsSubscriptionFilter{ - DestinationArn: cloudformation.GetAtt(prefix(""), "Arn"), - FilterPattern: trigger.FilterPattern, - LogGroupName: string(trigger.LogGroupName), - } - } - return template -} - -// LambdaConfig returns the configuration to use when creating the lambda. -func (c *CloudwatchLogs) LambdaConfig() *LambdaConfig { - return c.config.LambdaConfig -} - -// Policies returns a slice of policy to add to the lambda. -func (c *CloudwatchLogs) Policies() []iam.Role_Policy { - return []iam.Role_Policy{} -} diff --git a/x-pack/functionbeat/provider/aws/aws/cloudwatch_logs_test.go b/x-pack/functionbeat/provider/aws/aws/cloudwatch_logs_test.go deleted file mode 100644 index b9613720b83..00000000000 --- a/x-pack/functionbeat/provider/aws/aws/cloudwatch_logs_test.go +++ /dev/null @@ -1,153 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package aws - -import ( - "bytes" - "compress/gzip" - "encoding/base64" - "encoding/json" - "errors" - "testing" - "time" - - "github.com/aws/aws-lambda-go/events" - "github.com/stretchr/testify/assert" - - "github.com/elastic/beats/v7/libbeat/beat" - "github.com/elastic/beats/v7/libbeat/common" - "github.com/elastic/beats/v7/x-pack/functionbeat/function/provider" - conf "github.com/elastic/elastic-agent-libs/config" -) - -type arrayBackedClient struct { - Events []beat.Event - err error -} - -func (a *arrayBackedClient) Publish(event beat.Event) error { - if a.err != nil { - return a.err - } - a.Events = append(a.Events, event) - return nil -} - -func (a *arrayBackedClient) PublishAll(events []beat.Event) error { - if a.err != nil { - return a.err - } - a.Events = append(a.Events, events...) - return nil -} - -func (a *arrayBackedClient) Wait() { return } -func (a *arrayBackedClient) Close() error { return nil } - -func TestCloudwatchLogs(t *testing.T) { - cfg := conf.MustNewConfigFrom(map[string]interface{}{ - "name": "foobar", - "description": "my long description", - "role": "arn:aws:iam::000000000000:role/functionbeat", - "triggers": []map[string]interface{}{ - map[string]interface{}{ - "log_group_name": "foo", - "filter_name": "bar", - }, - }, - }) - - t.Run("when publish is succesful", func(t *testing.T) { - client := &arrayBackedClient{} - cwl, err := NewCloudwatchLogs(&provider.DefaultProvider{}, cfg) - if !assert.NoError(t, err) { - return - } - - c, _ := cwl.(*CloudwatchLogs) - handler := c.createHandler(client) - - err = handler(generateCloudwatchLogRawEvent()) - - assert.NoError(t, err) - }) - - t.Run("when publish is not succesful", func(t *testing.T) { - e := errors.New("something bad") - client := &arrayBackedClient{err: e} - cwl, err := NewCloudwatchLogs(&provider.DefaultProvider{}, cfg) - if !assert.NoError(t, err) { - return - } - - c, _ := cwl.(*CloudwatchLogs) - handler := c.createHandler(client) - - err = handler(generateCloudwatchLogRawEvent()) - - assert.Equal(t, e, err) - }) -} - -func generateCloudwatchLogRawEvent() events.CloudwatchLogsEvent { - rawEvent := events.CloudwatchLogsData{ - Owner: "foobar", - LogGroup: "foo", - LogStream: "/var/foobar", - LogEvents: []events.CloudwatchLogsLogEvent{ - events.CloudwatchLogsLogEvent{ - ID: "1234", - Timestamp: time.Now().Unix(), - Message: "hello world", - }, - }, - } - - b, _ := json.Marshal(&rawEvent) - - data := new(bytes.Buffer) - encoder := base64.NewEncoder(base64.StdEncoding, data) - zw := gzip.NewWriter(encoder) - zw.Write(b) - zw.Close() - encoder.Close() - - return events.CloudwatchLogsEvent{ - AWSLogs: events.CloudwatchLogsRawData{ - Data: data.String(), - }, - } -} - -func TestLogGroupName(t *testing.T) { - t.Run("valid name", func(t *testing.T) { - l := logGroupName("") - err := l.Unpack("helloworld") - if !assert.NoError(t, err) { - return - } - - assert.Equal(t, logGroupName("helloworld"), l) - }) - - t.Run("fail if contains invalid chars", func(t *testing.T) { - l := logGroupName("") - err := l.Unpack("hello world") - assert.Error(t, err) - }) - - t.Run("fail if too short", func(t *testing.T) { - l := logGroupName("") - err := l.Unpack("") - assert.Error(t, err) - }) - - t.Run("fail if above 512 chars", func(t *testing.T) { - r, _ := common.RandomBytes(513) - l := logGroupName("") - err := l.Unpack(string(r[:513])) - assert.Error(t, err) - }) -} diff --git a/x-pack/functionbeat/provider/aws/aws/config.go b/x-pack/functionbeat/provider/aws/aws/config.go deleted file mode 100644 index c7a7486d736..00000000000 --- a/x-pack/functionbeat/provider/aws/aws/config.go +++ /dev/null @@ -1,186 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package aws - -import ( - "fmt" - "regexp" - "strings" - "time" - "unicode" - "unicode/utf8" - - "github.com/dustin/go-humanize" - - "github.com/elastic/beats/v7/libbeat/common/cfgwarn" - awscommon "github.com/elastic/beats/v7/x-pack/libbeat/common/aws" -) - -// Config expose the configuration option the AWS provider. -type Config struct { - DeployBucket bucket `config:"deploy_bucket" validate:"nonzero,required"` - Region string `config:"region"` - Credentials awscommon.ConfigAWS `config:",inline"` -} - -func DefaultConfig() *Config { - return &Config{ - Credentials: awscommon.ConfigAWS{ - Endpoint: "s3.amazonaws.com", - }, - } -} - -func (c *Config) Validate() error { - if c.Credentials.Endpoint == "" { - return fmt.Errorf("functionbeat.providers.aws.endpoint cannot be empty") - } - return nil -} - -// maxMegabytes maximums memory that a lambda can use. -const maxMegabytes = 3008 - -// DefaultLambdaConfig confguration for AWS lambda function. -var ( - DefaultLambdaConfig = &LambdaConfig{ - MemorySize: 128 * 1024 * 1024, - Timeout: time.Second * 3, - Concurrency: 5, - } - - // Source: https://docs.aws.amazon.com/lambda/latest/dg/API_CreateFunction.html#SSS-CreateFunction-request-Role - arnRolePattern = "arn:(aws[a-zA-Z-]*)?:iam::\\d{12}:role/?[a-zA-Z_0-9+=,.@\\-_/]+" - roleRE = regexp.MustCompile(arnRolePattern) - - // Chars for resource name anything else will be replaced. - validChars = regexp.MustCompile("[^a-zA-Z0-9]") -) - -// LambdaConfig stores the common configuration of Lambda functions. -type LambdaConfig struct { - Concurrency int `config:"concurrency" validate:"min=0,max=1000"` - DeadLetterConfig *deadLetterConfig `config:"dead_letter_config"` - Description string `config:"description"` - MemorySize MemSizeFactor64 `config:"memory_size"` - Timeout time.Duration `config:"timeout" validate:"nonzero,positive"` - Role string `config:"role"` - VPCConfig *vpcConfig `config:"virtual_private_cloud"` - Tags map[string]string `config:"tags"` -} - -// Validate checks a LambdaConfig -func (c *LambdaConfig) Validate() error { - if c.MemorySize.Megabytes() == 0 { - return fmt.Errorf("'memory_size' need to be higher than 0 and must be a factor 64") - } - - if c.MemorySize.Megabytes() > maxMegabytes { - return fmt.Errorf("'memory_size' must be lower than %d", maxMegabytes) - } - - if c.Role != "" && !roleRE.MatchString(c.Role) { - return fmt.Errorf("invalid role: '%s', name must match pattern %s", c.Role, arnRolePattern) - } - - return validateTags(c.Tags) -} - -type deadLetterConfig struct { - TargetArn string `config:"target_arn"` -} - -type vpcConfig struct { - SecurityGroupIDs []string `config:"security_group_ids" validate:"required"` - SubnetIDs []string `config:"subnet_ids" validate:"required"` -} - -func validateTags(tags map[string]string) error { - for key, val := range tags { - if strings.HasPrefix(key, "aws:") { - return fmt.Errorf("key '%s' cannot be prefixed with 'aws:'", key) - } - if strings.HasPrefix(val, "aws:") { - return fmt.Errorf("value '%s' cannot be prefixed with 'aws:'", val) - } - keyLen := utf8.RuneCountInString(key) - if keyLen > 127 { - return fmt.Errorf("too long key; expected 127 chars, but got %d", keyLen) - } - valLen := utf8.RuneCountInString(val) - if valLen > 255 { - return fmt.Errorf("too long value; expected 255 chars, but got %d", valLen) - } - } - - return nil -} - -// MemSizeFactor64 implements a human understandable format for bytes but also make sure that all -// values used are a factor of 64. -type MemSizeFactor64 int - -// Unpack converts a size defined from a human readable format into bytes and verifies that the value -// is a multiple of 64. If the value is not multple of 64, it returns an error. -func (m *MemSizeFactor64) Unpack(v string) error { - sz, err := humanize.ParseBytes(v) - if isRawBytes(v) { - cfgwarn.Deprecate("7.0.0", "size now requires a unit (KiB, MiB, etc...), current value: %s.", v) - } - if err != nil { - return err - } - - if sz%64 != 0 { - return fmt.Errorf("number is not a multiple of 64, %d bytes (user value: %s)", sz, v) - } - - *m = MemSizeFactor64(sz) - return nil -} - -// Megabytes return the value in megabytes. -func (m *MemSizeFactor64) Megabytes() int { - return int(*m) / 1024 / 1024 -} - -func isRawBytes(v string) bool { - for _, c := range v { - if !unicode.IsDigit(c) { - return false - } - } - return true -} - -type bucket string - -// Do some high level validation on the bucket name, they have strict validations on the name on the API side. -// DOC: https://docs.aws.amazon.com/AmazonS3/latest/dev/BucketRestrictions.html#bucketnamingrules -func (b *bucket) Unpack(s string) error { - const max = 63 - const min = 3 - if len(s) > max { - return fmt.Errorf("bucket name '%s' is too long, name are restricted to %d chars", s, max) - } - - if len(s) < min { - return fmt.Errorf("bucket name '%s' is too short, name need to be at least %d chars long", s, min) - } - - const bucketNamePattern = "^[a-z0-9][a-z0-9.\\-]{1,61}[a-z0-9]$" - var bucketRE = regexp.MustCompile(bucketNamePattern) - if !bucketRE.MatchString(s) { - return fmt.Errorf("invalid bucket name: '%s', bucket name must match pattern: '%s'", s, bucketNamePattern) - } - - *b = bucket(s) - return nil -} - -// NormalizeResourceName extracts invalid chars. -func NormalizeResourceName(s string) string { - return validChars.ReplaceAllString(s, "") -} diff --git a/x-pack/functionbeat/provider/aws/aws/config_test.go b/x-pack/functionbeat/provider/aws/aws/config_test.go deleted file mode 100644 index ef1045f188e..00000000000 --- a/x-pack/functionbeat/provider/aws/aws/config_test.go +++ /dev/null @@ -1,135 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package aws - -import ( - "fmt" - "testing" - - "github.com/stretchr/testify/assert" -) - -func TestMemSizeFactor64(t *testing.T) { - t.Run("human format", func(t *testing.T) { - t.Run("value is a factor of 64", func(t *testing.T) { - v := MemSizeFactor64(0) - err := v.Unpack("128MiB") - if !assert.NoError(t, err) { - return - } - assert.Equal(t, MemSizeFactor64(128*1024*1024), v) - }) - }) - - t.Run("raw value", func(t *testing.T) { - t.Run("value is a factor of 64", func(t *testing.T) { - v := MemSizeFactor64(0) - err := v.Unpack(fmt.Sprintf("%d", 128*1024*1024)) - if !assert.NoError(t, err) { - return - } - assert.Equal(t, MemSizeFactor64(128*1024*1024), v) - }) - - t.Run("value is not a factor of 64", func(t *testing.T) { - v := MemSizeFactor64(0) - err := v.Unpack("121") - assert.Error(t, err) - }) - }) - - t.Run("returns the value in megabyte", func(t *testing.T) { - v := MemSizeFactor64(128 * 1024 * 1024) - assert.Equal(t, 128, v.Megabytes()) - }) -} -func TestBucket(t *testing.T) { - t.Run("valid bucket name", func(t *testing.T) { - b := bucket("") - err := b.Unpack("hello-bucket") - if !assert.NoError(t, err) { - return - } - assert.Equal(t, bucket("hello-bucket"), b) - }) - - t.Run("too long", func(t *testing.T) { - b := bucket("") - err := b.Unpack("hello-bucket-abc12345566789012345678901234567890123456789012345678901234567890") - assert.Error(t, err) - }) - - t.Run("too short", func(t *testing.T) { - b := bucket("") - err := b.Unpack("he") - assert.Error(t, err) - }) - - t.Run("bucket regex pattern, disallows semi-colon", func(t *testing.T) { - b := bucket("") - err := b.Unpack("asdfdaf;dfadsfadsf") - assert.Error(t, err) - }) - - t.Run("bucket regex pattern, disallows slash", func(t *testing.T) { - b := bucket("") - err := b.Unpack("asdfdaf/dfadsfadsf") - assert.Error(t, err) - }) - - t.Run("bucket regex pattern, allows dots", func(t *testing.T) { - b := bucket("") - err := b.Unpack("this.is.a.bucket") - if !assert.NoError(t, err) { - return - } - assert.Equal(t, bucket("this.is.a.bucket"), b) - }) - - t.Run("bucket regex pattern, allows hyphens", func(t *testing.T) { - b := bucket("") - err := b.Unpack("this-is-a-bucket") - if !assert.NoError(t, err) { - return - } - assert.Equal(t, bucket("this-is-a-bucket"), b) - }) -} - -func TestNormalize(t *testing.T) { - tests := []struct { - title string - candidate string - chars string - expected string - }{ - { - title: "when the string contains invalid chars", - candidate: "/var/log-alpha/tmp:ok", - expected: "varlogalphatmpok", - }, - { - title: "when we have an empty string", - candidate: "", - expected: "", - }, - { - title: "when we don't have any invalid chars", - candidate: "hello", - expected: "hello", - }, - { - title: "when the string contains underscore", - candidate: "/var/log-alpha/tmp:ok_moreok", - expected: "varlogalphatmpokmoreok", - }, - } - - for _, test := range tests { - t.Run(test.title, func(t *testing.T) { - assert.Equal(t, test.expected, NormalizeResourceName(test.candidate)) - }) - } -} diff --git a/x-pack/functionbeat/provider/aws/aws/kinesis.go b/x-pack/functionbeat/provider/aws/aws/kinesis.go deleted file mode 100644 index b286ab214d9..00000000000 --- a/x-pack/functionbeat/provider/aws/aws/kinesis.go +++ /dev/null @@ -1,226 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package aws - -import ( - "context" - "errors" - "fmt" - "sort" - "strings" - - "github.com/aws/aws-lambda-go/events" - lambdarunner "github.com/aws/aws-lambda-go/lambda" - "github.com/awslabs/goformation/v7/cloudformation" - "github.com/awslabs/goformation/v7/cloudformation/iam" - "github.com/awslabs/goformation/v7/cloudformation/lambda" - - "github.com/elastic/beats/v7/libbeat/feature" - "github.com/elastic/beats/v7/libbeat/publisher/pipeline" - "github.com/elastic/beats/v7/x-pack/functionbeat/function/provider" - "github.com/elastic/beats/v7/x-pack/functionbeat/function/telemetry" - "github.com/elastic/beats/v7/x-pack/functionbeat/provider/aws/aws/transformer" - conf "github.com/elastic/elastic-agent-libs/config" - "github.com/elastic/elastic-agent-libs/logp" -) - -type startingPosition uint - -const ( - // Looking at the documentation, Kinesis should also support `AT_TIMESTAMP` but looking at the - // request format for cloudformation, I don't see a way to define the timestamp. - // I've looked at other frameworks, and it seems a bug in the cloudformation API. - // doc: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html - trimHorizonPos startingPosition = iota + 1 - latestPos -) - -var ( - mapStartingPosition = map[string]startingPosition{ - "trim_horizon": trimHorizonPos, - "latest": latestPos, - } - - mapStartingPositionReverse = make(map[startingPosition]string, len(mapStartingPosition)) -) - -func init() { - for k, v := range mapStartingPosition { - mapStartingPositionReverse[v] = strings.ToUpper(k) - } -} - -func (s *startingPosition) Unpack(str string) error { - v, ok := mapStartingPosition[str] - if !ok { - validValues := make([]string, len(mapStartingPosition)) - pos := 0 - for k := range mapStartingPosition { - validValues[pos] = k - pos++ - } - return fmt.Errorf("unknown value %s, valid values are: %s", str, strings.Join(validValues, ", ")) - } - *s = v - return nil -} - -func (s *startingPosition) String() string { - v, ok := mapStartingPositionReverse[*s] - if !ok { - panic("unknown starting position: " + fmt.Sprint(*s)) - } - return v -} - -// KinesisConfig is the configuration for the Kinesis event type. -type KinesisConfig struct { - Description string `config:"description"` - Name string `config:"name" validate:"nonzero,required"` - Triggers []*KinesisTriggerConfig `config:"triggers"` - LambdaConfig *LambdaConfig `config:",inline"` -} - -// Validate validates the configuration. -func (cfg *KinesisConfig) Validate() error { - if len(cfg.Triggers) == 0 { - return errors.New("you need to specify at least one trigger") - } - return nil -} - -// KinesisTriggerConfig configuration for the current trigger. -type KinesisTriggerConfig struct { - EventSourceArn string `config:"event_source_arn" validate:"required"` - BatchSize int `config:"batch_size" validate:"min=100,max=10000"` - StartingPosition startingPosition `config:"starting_position"` - ParallelizationFactor int `config:"parallelization_factor" validate:"min=1,max=10"` -} - -// Unpack unpacks the trigger and make sure the defaults settings are correctly sets. -func (c *KinesisTriggerConfig) Unpack(cfg *conf.C) error { - type tmpConfig KinesisTriggerConfig - config := tmpConfig{ - BatchSize: 100, - StartingPosition: trimHorizonPos, - ParallelizationFactor: 1, - } - if err := cfg.Unpack(&config); err != nil { - return err - } - *c = KinesisTriggerConfig(config) - return nil -} - -// Kinesis receives events from a kinesis stream and forward them to elasticsearch. -type Kinesis struct { - log *logp.Logger - config *KinesisConfig -} - -// NewKinesis creates a new function to receives events from a kinesis stream. -func NewKinesis(provider provider.Provider, cfg *conf.C) (provider.Function, error) { - config := &KinesisConfig{LambdaConfig: DefaultLambdaConfig} - if err := cfg.Unpack(config); err != nil { - return nil, err - } - return &Kinesis{log: logp.NewLogger("kinesis"), config: config}, nil -} - -// KinesisDetails returns the details of the feature. -func KinesisDetails() feature.Details { - return feature.MakeDetails("Kinesis trigger", "receive events from a Kinesis stream", feature.Stable) -} - -// Run starts the lambda function and wait for web triggers. -func (k *Kinesis) Run(_ context.Context, client pipeline.ISyncClient, t telemetry.T) error { - t.AddTriggeredFunction() - - lambdarunner.Start(k.createHandler(client)) - return nil -} - -func (k *Kinesis) createHandler(client pipeline.ISyncClient) func(request events.KinesisEvent) error { - return func(request events.KinesisEvent) error { - k.log.Debugf("The handler receives %d events", len(request.Records)) - - events, err := transformer.KinesisEvent(request) - if err != nil { - return err - } - - if err = client.PublishAll(events); err != nil { - k.log.Errorf("Could not publish events to the pipeline, error: %+v", err) - return err - } - client.Wait() - return nil - } -} - -// Name return the name of the lambda function. -func (k *Kinesis) Name() string { - return "kinesis" -} - -// LambdaConfig returns the configuration to use when creating the lambda. -func (k *Kinesis) LambdaConfig() *LambdaConfig { - return k.config.LambdaConfig -} - -// Template returns the cloudformation template for configuring the service with the specified -// triggers. -func (k *Kinesis) Template() *cloudformation.Template { - template := cloudformation.NewTemplate() - prefix := func(suffix string) string { - return NormalizeResourceName("fnb" + k.config.Name + suffix) - } - - for _, trigger := range k.config.Triggers { - resourceName := prefix(k.Name() + trigger.EventSourceArn) - template.Resources[resourceName] = &lambda.EventSourceMapping{ - BatchSize: cloudformation.Int(trigger.BatchSize), - ParallelizationFactor: cloudformation.Int(trigger.ParallelizationFactor), - EventSourceArn: cloudformation.String(trigger.EventSourceArn), - FunctionName: cloudformation.GetAtt(prefix(""), "Arn"), - StartingPosition: cloudformation.String(trigger.StartingPosition.String()), - } - } - - return template -} - -// Policies returns a slice of policy to add to the lambda role. -func (k *Kinesis) Policies() []iam.Role_Policy { - resources := make([]string, len(k.config.Triggers)) - for idx, trigger := range k.config.Triggers { - resources[idx] = trigger.EventSourceArn - } - - // Give us a chance to generate the same document indenpendant of the changes, - // to help with updates. - sort.Strings(resources) - - policies := []iam.Role_Policy{ - iam.Role_Policy{ - PolicyName: cloudformation.Join("-", []string{"fnb", "kinesis", k.config.Name}), - PolicyDocument: map[string]interface{}{ - "Statement": []map[string]interface{}{ - map[string]interface{}{ - "Action": []string{ - "kinesis:GetRecords", - "kinesis:GetShardIterator", - "Kinesis:DescribeStream", - }, - "Effect": "Allow", - "Resource": resources, - }, - }, - }, - }, - } - - return policies -} diff --git a/x-pack/functionbeat/provider/aws/aws/kinesis_test.go b/x-pack/functionbeat/provider/aws/aws/kinesis_test.go deleted file mode 100644 index 20d92ce3606..00000000000 --- a/x-pack/functionbeat/provider/aws/aws/kinesis_test.go +++ /dev/null @@ -1,302 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package aws - -import ( - "crypto/md5" - "errors" - "fmt" - "strconv" - "testing" - - "github.com/aws/aws-lambda-go/events" - "github.com/awslabs/kinesis-aggregation/go/v2/deaggregator" - aggRecProto "github.com/awslabs/kinesis-aggregation/go/v2/records" - "github.com/stretchr/testify/assert" - "google.golang.org/protobuf/proto" - "google.golang.org/protobuf/runtime/protoimpl" - - "github.com/elastic/beats/v7/x-pack/functionbeat/function/provider" - conf "github.com/elastic/elastic-agent-libs/config" -) - -func TestKinesis(t *testing.T) { - cfg := conf.MustNewConfigFrom(map[string]interface{}{ - "name": "foobar", - "triggers": []map[string]interface{}{ - map[string]interface{}{ - "event_source_arn": "abc123", - }, - }, - }) - - t.Run("when publish is successful", func(t *testing.T) { - client := &arrayBackedClient{} - k, err := NewKinesis(&provider.DefaultProvider{}, cfg) - if !assert.NoError(t, err) { - return - } - - c, _ := k.(*Kinesis) - handler := c.createHandler(client) - err = handler(generateKinesisEvent()) - assert.NoError(t, err) - }) - - t.Run("when publish with agg is successful", func(t *testing.T) { - client := &arrayBackedClient{} - k, err := NewKinesis(&provider.DefaultProvider{}, cfg) - if !assert.NoError(t, err) { - return - } - - c, _ := k.(*Kinesis) - handler := c.createHandler(client) - err = handler(generateAggregatedKinesisEvent(true)) - assert.NoError(t, err) - }) - - t.Run("when publish is not successful", func(t *testing.T) { - e := errors.New("something bad") - client := &arrayBackedClient{err: e} - - k, err := NewKinesis(&provider.DefaultProvider{}, cfg) - if !assert.NoError(t, err) { - return - } - - c, _ := k.(*Kinesis) - handler := c.createHandler(client) - err = handler(generateKinesisEvent()) - assert.Equal(t, e, err) - }) - - t.Run("when publish with agg is not successful", func(t *testing.T) { - client := &arrayBackedClient{} - k, err := NewKinesis(&provider.DefaultProvider{}, cfg) - if !assert.NoError(t, err) { - return - } - - c, _ := k.(*Kinesis) - handler := c.createHandler(client) - err = handler(generateAggregatedKinesisEvent(false)) - assert.Error(t, err) - }) - - t.Run("test config validation", testKinesisConfig) - t.Run("test starting position", testStartingPosition) -} - -func generateKinesisEvent() events.KinesisEvent { - return events.KinesisEvent{ - Records: []events.KinesisEventRecord{ - events.KinesisEventRecord{ - AwsRegion: "east-1", - EventID: "1234", - EventName: "connect", - EventSource: "web", - EventSourceArn: "arn:aws:iam::00000000:role/functionbeat", - Kinesis: events.KinesisRecord{ - Data: []byte("hello world"), - PartitionKey: "abc123", - SequenceNumber: "12345", - KinesisSchemaVersion: "v1", - }, - }, - }, - } -} - -func generateAggregatedKinesisEvent(validRec bool) events.KinesisEvent { - // Heavily based on https://github.com/awslabs/kinesis-aggregation/blob/master/go/deaggregator/deaggregator_test.go - aggRec := &aggRecProto.AggregatedRecord{} - unquotedHeader, err := strconv.Unquote(deaggregator.KplMagicHeader) - if err != nil { - panic(err) - } - aggRecBytes := []byte(unquotedHeader) - partKeyTable := make([]string, 0) - partKey := uint64(0) - hashKey := uint64(0) - r := &aggRecProto.Record{ - ExplicitHashKeyIndex: &hashKey, - Data: []byte("hello world"), - Tags: make([]*aggRecProto.Tag, 0), - } - // This seems to be the only way to trigger the deaggregation module to return an error when needed - if validRec { - r.PartitionKeyIndex = &partKey - } - aggRec.Records = append(aggRec.Records, r) - partKeyTable = append(partKeyTable, "0") - - aggRec.PartitionKeyTable = partKeyTable - data, _ := proto.Marshal(protoimpl.X.ProtoMessageV2Of(aggRec)) - md5Hash := md5.Sum(data) - aggRecBytes = append(aggRecBytes, data...) - aggRecBytes = append(aggRecBytes, md5Hash[:]...) - - return events.KinesisEvent{ - Records: []events.KinesisEventRecord{ - { - AwsRegion: "east-1", - EventID: "1234", - EventName: "connect", - EventSource: "web", - EventSourceArn: "arn:aws:iam::00000000:role/functionbeat", - Kinesis: events.KinesisRecord{ - Data: aggRecBytes, - PartitionKey: "abc123", - SequenceNumber: "12345", - KinesisSchemaVersion: "v1", - }, - }, - }, - } -} - -func testKinesisConfig(t *testing.T) { - tests := map[string]struct { - valid bool - rawConfig map[string]interface{} - expected *KinesisConfig - }{ - "minimal valid configuration": { - valid: true, - rawConfig: map[string]interface{}{ - "name": "mysuperfunctionname", - "description": "mylong description", - "triggers": []map[string]interface{}{ - map[string]interface{}{ - "event_source_arn": "mycustomarn", - }, - }, - }, - }, - "missing event triggers": { - valid: false, - rawConfig: map[string]interface{}{ - "name": "mysuperfunctionname", - "description": "mylong description", - }, - }, - "empty or missing event source arn": { - valid: false, - rawConfig: map[string]interface{}{ - "name": "mysuperfunctionname", - "description": "mylong description", - "triggers": []map[string]interface{}{ - map[string]interface{}{ - "event_source_arn": "", - }, - }, - }, - }, - "test upper bound batch size limit": { - valid: false, - rawConfig: map[string]interface{}{ - "name": "mysuperfunctionname", - "description": "mylong description", - "triggers": []map[string]interface{}{ - map[string]interface{}{ - "event_source_arn": "abc123", - "batch_size": 20000, - }, - }, - }, - }, - "test lower bound batch size limit": { - valid: false, - rawConfig: map[string]interface{}{ - "name": "mysuperfunctionname", - "description": "mylong description", - "triggers": []map[string]interface{}{ - map[string]interface{}{ - "event_source_arn": "abc123", - "batch_size": 10, - }, - }, - }, - }, - "test upper bound parallelization factor limit": { - valid: false, - rawConfig: map[string]interface{}{ - "name": "mysuperfunctionname", - "description": "mylong description", - "triggers": []map[string]interface{}{ - map[string]interface{}{ - "event_source_arn": "abc123", - "parallelization_factor": 13, - }, - }, - }, - }, - "test lower bound parallelization factor limit": { - valid: false, - rawConfig: map[string]interface{}{ - "name": "mysuperfunctionname", - "description": "mylong description", - "triggers": []map[string]interface{}{ - map[string]interface{}{ - "event_source_arn": "abc123", - "parallelization_factor": 0, - }, - }, - }, - }, - "test default values": { - valid: true, - rawConfig: map[string]interface{}{ - "name": "mysuperfunctionname", - "description": "mylongdescription", - "triggers": []map[string]interface{}{ - map[string]interface{}{ - "event_source_arn": "abc123", - }, - }, - }, - expected: &KinesisConfig{ - Name: "mysuperfunctionname", - Description: "mylongdescription", - LambdaConfig: DefaultLambdaConfig, - Triggers: []*KinesisTriggerConfig{ - &KinesisTriggerConfig{ - EventSourceArn: "abc123", - BatchSize: 100, - StartingPosition: trimHorizonPos, - ParallelizationFactor: 1, - }, - }, - }, - }, - } - - for name, test := range tests { - t.Run(name, func(t *testing.T) { - cfg := conf.MustNewConfigFrom(test.rawConfig) - config := &KinesisConfig{LambdaConfig: DefaultLambdaConfig} - err := cfg.Unpack(config) - if !assert.Equal(t, test.valid, err == nil, fmt.Sprintf("error: %+v", err)) { - return - } - - if test.expected != nil { - assert.Equal(t, test.expected, config) - } - }) - } -} - -func testStartingPosition(t *testing.T) { - // NOTE(ph) when adding support for at_timestamp we also need to make sure the cloudformation - // template send the timestamp. - // doc: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html - t.Run("AT_TIMESTAMP is not supported yet", func(t *testing.T) { - var s startingPosition - err := s.Unpack("at_timestamp") - assert.Error(t, err) - }) -} diff --git a/x-pack/functionbeat/provider/aws/aws/sqs.go b/x-pack/functionbeat/provider/aws/aws/sqs.go deleted file mode 100644 index adf5f5a16de..00000000000 --- a/x-pack/functionbeat/provider/aws/aws/sqs.go +++ /dev/null @@ -1,164 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package aws - -import ( - "context" - "errors" - "sort" - - "github.com/aws/aws-lambda-go/events" - lambdarunner "github.com/aws/aws-lambda-go/lambda" - "github.com/awslabs/goformation/v7/cloudformation" - "github.com/awslabs/goformation/v7/cloudformation/iam" - "github.com/awslabs/goformation/v7/cloudformation/lambda" - - "github.com/elastic/beats/v7/libbeat/feature" - "github.com/elastic/beats/v7/libbeat/publisher/pipeline" - "github.com/elastic/beats/v7/x-pack/functionbeat/function/provider" - "github.com/elastic/beats/v7/x-pack/functionbeat/function/telemetry" - "github.com/elastic/beats/v7/x-pack/functionbeat/provider/aws/aws/transformer" - conf "github.com/elastic/elastic-agent-libs/config" - "github.com/elastic/elastic-agent-libs/logp" -) - -const batchSize = 10 - -// SQSConfig is the configuration for the SQS event type. -type SQSConfig struct { - Triggers []*SQSTriggerConfig `config:"triggers"` - Description string `config:"description"` - Name string `config:"name" validate:"nonzero,required"` - LambdaConfig *LambdaConfig `config:",inline"` -} - -// SQSTriggerConfig configuration for the current trigger. -type SQSTriggerConfig struct { - EventSourceArn string `config:"event_source_arn"` -} - -// Validate validates the configuration. -func (cfg *SQSConfig) Validate() error { - if len(cfg.Triggers) == 0 { - return errors.New("you need to specify at least one trigger") - } - return nil -} - -// SQS receives events from the web service and forward them to elasticsearch. -type SQS struct { - log *logp.Logger - config *SQSConfig -} - -// NewSQS creates a new function to receives events from a SQS queue. -func NewSQS(provider provider.Provider, cfg *conf.C) (provider.Function, error) { - config := &SQSConfig{LambdaConfig: DefaultLambdaConfig} - if err := cfg.Unpack(config); err != nil { - return nil, err - } - return &SQS{log: logp.NewLogger("sqs"), config: config}, nil -} - -// SQSDetails returns the details of the feature. -func SQSDetails() feature.Details { - return feature.MakeDetails("SQS trigger", "receive events from a SQS queue", feature.Stable) -} - -// Run starts the lambda function and wait for web triggers. -func (s *SQS) Run(_ context.Context, client pipeline.ISyncClient, t telemetry.T) error { - t.AddTriggeredFunction() - - lambdarunner.Start(s.createHandler(client)) - return nil -} - -func (s *SQS) createHandler(client pipeline.ISyncClient) func(request events.SQSEvent) error { - return func(request events.SQSEvent) error { - s.log.Debugf("The handler receives %d events", len(request.Records)) - - events := transformer.SQS(request) - - if err := client.PublishAll(events); err != nil { - s.log.Errorf("Could not publish events to the pipeline, error: %+v", err) - return err - } - client.Wait() - return nil - } -} - -// Name return the name of the lambda function. -func (s *SQS) Name() string { - return "sqs" -} - -// Template returns the cloudformation template for configuring the service with the specified triggers. -func (s *SQS) Template() *cloudformation.Template { - template := cloudformation.NewTemplate() - - prefix := func(suffix string) string { - return NormalizeResourceName("fnb" + s.config.Name + suffix) - } - - for _, trigger := range s.config.Triggers { - resourceName := prefix("SQS") + NormalizeResourceName(trigger.EventSourceArn) - template.Resources[resourceName] = &lambda.EventSourceMapping{ - BatchSize: cloudformation.Int(batchSize), - EventSourceArn: cloudformation.String(trigger.EventSourceArn), - FunctionName: cloudformation.GetAtt(prefix(""), "Arn"), - } - } - return template -} - -// Policies returns a slice of policies to add to the lambda role. -func (s *SQS) Policies() []iam.Role_Policy { - resources := make([]string, len(s.config.Triggers)) - for idx, trigger := range s.config.Triggers { - resources[idx] = trigger.EventSourceArn - } - - // Give us a chance to generate the same document indenpendant of the changes, - // to help with updates. - sort.Strings(resources) - - // SQS Roles permissions: - // - lambda:CreateEventSourceMapping - // - lambda:ListEventSourceMappings - // - lambda:ListFunctions - // - // Lambda Role permission - // - sqs:ChangeMessageVisibility - // - sqs:DeleteMessage - // - sqs:GetQueueAttributes - // - sqs:ReceiveMessage - policies := []iam.Role_Policy{ - iam.Role_Policy{ - PolicyName: cloudformation.Join("-", []string{"fnb", "sqs", s.config.Name}), - PolicyDocument: map[string]interface{}{ - "Statement": []map[string]interface{}{ - map[string]interface{}{ - "Action": []string{ - "sqs:ChangeMessageVisibility", - "sqs:DeleteMessage", - "sqs:GetQueueAttributes", - "sqs:ReceiveMessage", - }, - "Effect": "Allow", - "Resource": resources, - }, - }, - }, - }, - } - - return policies -} - -// LambdaConfig returns the configuration to use when creating the lambda. -func (s *SQS) LambdaConfig() *LambdaConfig { - return s.config.LambdaConfig -} diff --git a/x-pack/functionbeat/provider/aws/aws/sqs_test.go b/x-pack/functionbeat/provider/aws/aws/sqs_test.go deleted file mode 100644 index 88a45cb9793..00000000000 --- a/x-pack/functionbeat/provider/aws/aws/sqs_test.go +++ /dev/null @@ -1,67 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package aws - -import ( - "errors" - "testing" - - "github.com/aws/aws-lambda-go/events" - "github.com/stretchr/testify/assert" - - "github.com/elastic/beats/v7/x-pack/functionbeat/function/provider" - conf "github.com/elastic/elastic-agent-libs/config" -) - -func TestSQS(t *testing.T) { - cfg := conf.MustNewConfigFrom(map[string]interface{}{ - "name": "foobar", - "triggers": []map[string]interface{}{ - map[string]interface{}{ - "event_source_arn": "abc1234", - }, - }, - }) - - t.Run("when publish is succesful", func(t *testing.T) { - client := &arrayBackedClient{} - s, err := NewSQS(&provider.DefaultProvider{}, cfg) - if !assert.NoError(t, err) { - return - } - - c, _ := s.(*SQS) - handler := c.createHandler(client) - err = handler(generateSQSEvent()) - assert.NoError(t, err) - }) - - t.Run("when publish is not succesful", func(t *testing.T) { - e := errors.New("something bad") - client := &arrayBackedClient{err: e} - - s, err := NewSQS(&provider.DefaultProvider{}, cfg) - if !assert.NoError(t, err) { - return - } - - c, _ := s.(*SQS) - handler := c.createHandler(client) - err = handler(generateSQSEvent()) - assert.Equal(t, e, err) - }) -} - -func generateSQSEvent() events.SQSEvent { - return events.SQSEvent{ - Records: []events.SQSMessage{ - events.SQSMessage{ - MessageId: "1234", - ReceiptHandle: "12345", - Body: "hello world", - }, - }, - } -} diff --git a/x-pack/functionbeat/provider/aws/aws/transformer/transformer.go b/x-pack/functionbeat/provider/aws/aws/transformer/transformer.go deleted file mode 100644 index 3bf464317a0..00000000000 --- a/x-pack/functionbeat/provider/aws/aws/transformer/transformer.go +++ /dev/null @@ -1,234 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package transformer - -import ( - "bytes" - "compress/gzip" - "encoding/base64" - "encoding/json" - "errors" - "io" - "time" - - "github.com/aws/aws-lambda-go/events" - "github.com/aws/aws-sdk-go-v2/service/kinesis/types" - "github.com/awslabs/kinesis-aggregation/go/v2/deaggregator" - - "github.com/elastic/beats/v7/libbeat/beat" - "github.com/elastic/elastic-agent-libs/mapstr" -) - -// Centralize anything related to ECS into a common file. -// TODO: Look at the fields to align them with ECS. -// TODO: how to keep the fields in sync with AWS? -// TODO: api gateway proxy a lot more information is available. - -// CloudwatchLogs takes an CloudwatchLogsData and transform it into a beat event. -func CloudwatchLogs(request events.CloudwatchLogsData) []beat.Event { - beatEvents := make([]beat.Event, len(request.LogEvents)) - - for idx, logEvent := range request.LogEvents { - beatEvents[idx] = beat.Event{ - Timestamp: time.Unix(0, logEvent.Timestamp*1000000), - Fields: mapstr.M{ - "event": mapstr.M{ - "kind": "event", - }, - "cloud": mapstr.M{ - "provider": "aws", - }, - "message": logEvent.Message, - "id": logEvent.ID, - "owner": request.Owner, - "log_stream": request.LogStream, - "log_group": request.LogGroup, - "message_type": request.MessageType, - "subscription_filters": request.SubscriptionFilters, - }, - } - } - - return beatEvents -} - -// APIGatewayProxyRequest takes a web request on the api gateway proxy and transform it into a beat event. -func APIGatewayProxyRequest(request events.APIGatewayProxyRequest) beat.Event { - return beat.Event{ - Timestamp: time.Now(), - Fields: mapstr.M{ - "event": mapstr.M{ - "kind": "event", - "category": []string{"network"}, - "type": []string{"connection", "protocol"}, - }, - "cloud": mapstr.M{ - "provider": "aws", - "account.id": request.RequestContext.AccountID, - }, - "network": mapstr.M{ - "transport": "tcp", - "protocol": "http", - }, - "resource": request.Resource, - "path": request.Path, - "method": request.HTTPMethod, - "headers": request.Headers, // TODO: ECS map[string] - "query_string": request.QueryStringParameters, // TODO: map[string], might conflict with ECS - "path_parameters": request.PathParameters, - "body": request.Body, // TODO: could be JSON, json processor? could be used by other functions. - "is_base64_encoded": request.IsBase64Encoded, - }, - } -} - -// KinesisEvent takes a kinesis event and create multiples beat events. -// DOCS: https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html -func KinesisEvent(request events.KinesisEvent) ([]beat.Event, error) { - var beatEvents []beat.Event - for _, record := range request.Records { - kr := types.Record{ - ApproximateArrivalTimestamp: &record.Kinesis.ApproximateArrivalTimestamp.Time, - Data: record.Kinesis.Data, - EncryptionType: types.EncryptionType(record.Kinesis.EncryptionType), - PartitionKey: &record.Kinesis.PartitionKey, - SequenceNumber: &record.Kinesis.SequenceNumber, - } - deaggRecords, err := deaggregator.DeaggregateRecords([]types.Record{kr}) - if err != nil { - return nil, err - } - - for _, deaggRecord := range deaggRecords { - beatEvents = append(beatEvents, beat.Event{ - Timestamp: *deaggRecord.ApproximateArrivalTimestamp, - Fields: mapstr.M{ - "event": mapstr.M{ - "kind": "event", - }, - "cloud": mapstr.M{ - "provider": "aws", - "region": record.AwsRegion, - }, - "event_id": record.EventID, - "event_name": record.EventName, - "event_source": record.EventSource, - "event_source_arn": record.EventSourceArn, - "event_version": record.EventVersion, - "aws_region": record.AwsRegion, - "message": string(deaggRecord.Data), - "kinesis_partition_key": *deaggRecord.PartitionKey, - "kinesis_schema_version": record.Kinesis.KinesisSchemaVersion, - "kinesis_sequence_number": *deaggRecord.SequenceNumber, - "kinesis_encryption_type": deaggRecord.EncryptionType, - }, - }) - } - } - return beatEvents, nil -} - -// CloudwatchKinesisEvent takes a Kinesis event containing Cloudwatch logs and creates events for all -// Cloudwatch logs. -func CloudwatchKinesisEvent(request events.KinesisEvent, base64Encoded, compressed bool) ([]beat.Event, error) { - var evts []beat.Event - for _, record := range request.Records { - envelopeFields := mapstr.M{ - "event": mapstr.M{ - "kind": "event", - }, - "cloud": mapstr.M{ - "provider": "aws", - "region": record.AwsRegion, - }, - "event_id": record.EventID, - "event_name": record.EventName, - "event_source": record.EventSource, - "event_source_arn": record.EventSourceArn, - "event_version": record.EventVersion, - "aws_region": record.AwsRegion, - "kinesis_partition_key": record.Kinesis.PartitionKey, - "kinesis_schema_version": record.Kinesis.KinesisSchemaVersion, - "kinesis_sequence_number": record.Kinesis.SequenceNumber, - "kinesis_encryption_type": record.Kinesis.EncryptionType, - } - - kinesisData := record.Kinesis.Data - if base64Encoded { - var err error - kinesisData, err = base64.StdEncoding.DecodeString(string(kinesisData)) - if err != nil { - return nil, err - } - } - - if compressed { - inBuf := bytes.NewBuffer(record.Kinesis.Data) - r, err := gzip.NewReader(inBuf) - if err != nil { - return nil, err - } - - var outBuf bytes.Buffer - for { - _, err := io.CopyN(&outBuf, r, 1024) - if err != nil { - if errors.Is(err, io.EOF) { - break - } - _ = r.Close() - return nil, err - } - } - - err = r.Close() - if err != nil { - return nil, err - } - kinesisData = outBuf.Bytes() - } - - var cloudwatchEvents events.CloudwatchLogsData - err := json.Unmarshal(kinesisData, &cloudwatchEvents) - if err != nil { - return nil, err - } - - cwEvts := CloudwatchLogs(cloudwatchEvents) - for _, cwe := range cwEvts { - cwe.Fields.DeepUpdate(envelopeFields) - evts = append(evts, cwe) - } - } - return evts, nil -} - -// SQS takes a SQS event and create multiples beat events. -func SQS(request events.SQSEvent) []beat.Event { - beatEvents := make([]beat.Event, len(request.Records)) - for idx, record := range request.Records { - beatEvents[idx] = beat.Event{ - Timestamp: time.Now(), - Fields: mapstr.M{ - "event": mapstr.M{ - "kind": "event", - }, - "cloud": mapstr.M{ - "provider": "aws", - "region": record.AWSRegion, - }, - "message_id": record.MessageId, - "receipt_handle": record.ReceiptHandle, - "message": record.Body, - "attributes": record.Attributes, - "event_source": record.EventSource, - "event_source_arn": record.EventSourceARN, - "aws_region": record.AWSRegion, - }, - // TODO: SQS message attributes missing, need to check doc - } - } - return beatEvents -} diff --git a/x-pack/functionbeat/provider/aws/aws/transformer/transformer_test.go b/x-pack/functionbeat/provider/aws/aws/transformer/transformer_test.go deleted file mode 100644 index ae0dcb12eee..00000000000 --- a/x-pack/functionbeat/provider/aws/aws/transformer/transformer_test.go +++ /dev/null @@ -1,403 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package transformer - -import ( - "crypto/md5" - "encoding/base64" - "fmt" - "math/rand" - "strconv" - "testing" - "time" - - "github.com/aws/aws-sdk-go-v2/service/kinesis/types" - "google.golang.org/protobuf/runtime/protoimpl" - - "github.com/aws/aws-lambda-go/events" - "github.com/awslabs/kinesis-aggregation/go/v2/deaggregator" - aggRecProto "github.com/awslabs/kinesis-aggregation/go/v2/records" - "github.com/stretchr/testify/assert" - "google.golang.org/protobuf/proto" - - "github.com/elastic/beats/v7/libbeat/beat" - "github.com/elastic/elastic-agent-libs/mapstr" -) - -func TestCloudwatch(t *testing.T) { - logsData := events.CloudwatchLogsData{ - Owner: "me", - LogGroup: "my-group", - LogStream: "stream", - SubscriptionFilters: []string{"MyFilter"}, - MessageType: "DATA_MESSAGE", - LogEvents: []events.CloudwatchLogsLogEvent{ - { - ID: "1234567890123456789", - Timestamp: 1566908691193, - Message: "my interesting message", - }, - }, - } - - events := CloudwatchLogs(logsData) - assert.Equal(t, 1, len(events)) - - expectedTime, err := time.ParseInLocation(time.RFC3339, "2019-08-27T12:24:51.193+00:00", time.UTC) - assert.NoError(t, err) - - expectedEvent := beat.Event{ - Timestamp: expectedTime, - Fields: mapstr.M{ - "event": mapstr.M{ - "kind": "event", - }, - "cloud": mapstr.M{ - "provider": "aws", - }, - "message": "my interesting message", - "id": "1234567890123456789", - "owner": "me", - "log_stream": "stream", - "log_group": "my-group", - "message_type": "DATA_MESSAGE", - "subscription_filters": []string{"MyFilter"}, - }, - } - - assert.Equal(t, expectedEvent.Fields, events[0].Fields) - assert.Equal(t, expectedEvent.Timestamp, events[0].Timestamp.UTC()) -} - -func TestKinesis(t *testing.T) { - t.Run("when kinesis event is successful", func(t *testing.T) { - request := events.KinesisEvent{ - Records: []events.KinesisEventRecord{ - events.KinesisEventRecord{ - AwsRegion: "us-east-1", - EventID: "1234", - EventName: "connect", - EventSource: "web", - EventVersion: "1.0", - EventSourceArn: "arn:aws:iam::00000000:role/functionbeat", - Kinesis: events.KinesisRecord{ - Data: []byte("hello world"), - PartitionKey: "abc123", - SequenceNumber: "12345", - KinesisSchemaVersion: "1.0", - EncryptionType: "test", - }, - }, - }, - } - - events, err := KinesisEvent(request) - assert.NoError(t, err) - assert.Equal(t, 1, len(events)) - - fields := mapstr.M{ - "cloud": mapstr.M{ - "provider": "aws", - "region": "us-east-1", - }, - "event": mapstr.M{ - "kind": "event", - }, - "event_id": "1234", - "event_name": "connect", - "event_source": "web", - "event_source_arn": "arn:aws:iam::00000000:role/functionbeat", - "event_version": "1.0", - "aws_region": "us-east-1", - "message": "hello world", - "kinesis_partition_key": "abc123", - "kinesis_schema_version": "1.0", - "kinesis_sequence_number": "12345", - "kinesis_encryption_type": types.EncryptionType("test"), - } - - assert.Equal(t, fields, events[0].Fields) - }) - - t.Run("when kinesis event with agg is successful", func(t *testing.T) { - rand.Seed(time.Now().UnixNano()) - min, max := 2, 20 - numRecords := rand.Intn(max-min) + min - aggRecBytes := generateKinesisAggregateRecord(numRecords, true) - - request := events.KinesisEvent{ - Records: []events.KinesisEventRecord{ - events.KinesisEventRecord{ - AwsRegion: "us-east-1", - EventID: "1234", - EventName: "connect", - EventSource: "web", - EventVersion: "1.0", - EventSourceArn: "arn:aws:iam::00000000:role/functionbeat", - Kinesis: events.KinesisRecord{ - Data: aggRecBytes, - PartitionKey: "ignored", - SequenceNumber: "12345", - KinesisSchemaVersion: "1.0", - EncryptionType: "test", - }, - }, - }, - } - - events, err := KinesisEvent(request) - assert.NoError(t, err) - assert.Equal(t, numRecords, len(events)) - - envelopeFields := mapstr.M{ - "cloud": mapstr.M{ - "provider": "aws", - "region": "us-east-1", - }, - "event": mapstr.M{ - "kind": "event", - }, - "event_id": "1234", - "event_name": "connect", - "event_source": "web", - "event_source_arn": "arn:aws:iam::00000000:role/functionbeat", - "event_version": "1.0", - "aws_region": "us-east-1", - "kinesis_schema_version": "1.0", - "kinesis_sequence_number": "12345", - "kinesis_encryption_type": types.EncryptionType("test"), - } - - var expectedInnerFields []mapstr.M - for i := 0; i < numRecords; i++ { - expectedInnerFields = append(expectedInnerFields, mapstr.M{ - "message": fmt.Sprintf("%s %d", "hello world", i), - "kinesis_partition_key": fmt.Sprintf("%s %d", "partKey", i), - }) - } - - for i, expectedFields := range expectedInnerFields { - expectedFields.Update(envelopeFields) - assert.Equal(t, expectedFields, events[i].Fields) - } - }) - - t.Run("when kinesis event with agg is not successful", func(t *testing.T) { - aggRecBytes := generateKinesisAggregateRecord(2, false) - - request := events.KinesisEvent{ - Records: []events.KinesisEventRecord{ - events.KinesisEventRecord{ - AwsRegion: "us-east-1", - EventID: "1234", - EventName: "connect", - EventSource: "web", - EventVersion: "1.0", - EventSourceArn: "arn:aws:iam::00000000:role/functionbeat", - Kinesis: events.KinesisRecord{ - Data: aggRecBytes, - PartitionKey: "abc123", - SequenceNumber: "12345", - KinesisSchemaVersion: "1.0", - EncryptionType: "test", - }, - }, - }, - } - - events, err := KinesisEvent(request) - assert.Error(t, err) - assert.Nil(t, events) - }) - - t.Run("when kinesis event with real example agg payload is successful", func(t *testing.T) { - rand.Seed(time.Now().UnixNano()) - numRecords := 10 - aggRecBytes, err := base64.StdEncoding.DecodeString("84mawgoIejJKSjl6dFgaEwgAGg97ImtleSI6InZhbHVlIn0aEwgAGg9" + - "7ImtleSI6InZhbHVlIn0aEwgAGg97ImtleSI6InZhbHVlIn0aEwgAGg97ImtleSI6InZhbHVlIn0aEwgAGg97ImtleSI6InZhbHVlIn" + - "0aEwgAGg97ImtleSI6InZhbHVlIn0aEwgAGg97ImtleSI6InZhbHVlIn0aEwgAGg97ImtleSI6InZhbHVlIn0aEwgAGg97ImtleSI6I" + - "nZhbHVlIn0aEwgAGg97ImtleSI6InZhbHVlIn3xj2DFMGZ0aNQC7aexsnkU") - assert.NoError(t, err) - - request := events.KinesisEvent{ - Records: []events.KinesisEventRecord{ - events.KinesisEventRecord{ - AwsRegion: "us-east-1", - EventID: "1234", - EventName: "connect", - EventSource: "web", - EventVersion: "1.0", - EventSourceArn: "arn:aws:iam::00000000:role/functionbeat", - Kinesis: events.KinesisRecord{ - Data: aggRecBytes, - PartitionKey: "ignored", - SequenceNumber: "12345", - KinesisSchemaVersion: "1.0", - EncryptionType: "test", - }, - }, - }, - } - - events, err := KinesisEvent(request) - assert.NoError(t, err) - assert.Equal(t, numRecords, len(events)) - - envelopeFields := mapstr.M{ - "cloud": mapstr.M{ - "provider": "aws", - "region": "us-east-1", - }, - "event": mapstr.M{ - "kind": "event", - }, - "event_id": "1234", - "event_name": "connect", - "event_source": "web", - "event_source_arn": "arn:aws:iam::00000000:role/functionbeat", - "event_version": "1.0", - "aws_region": "us-east-1", - "kinesis_schema_version": "1.0", - "kinesis_sequence_number": "12345", - "kinesis_encryption_type": types.EncryptionType("test"), - "kinesis_partition_key": "z2JJ9ztX", - "message": `{"key":"value"}`, - } - - for i := 0; i < numRecords; i++ { - assert.Equal(t, envelopeFields, events[i].Fields) - } - }) -} - -func TestCloudwatchKinesis(t *testing.T) { - request := events.KinesisEvent{ - Records: []events.KinesisEventRecord{ - events.KinesisEventRecord{ - AwsRegion: "us-east-1", - EventID: "1234", - EventName: "connect", - EventSource: "web", - EventVersion: "1.0", - EventSourceArn: "arn:aws:iam::00000000:role/functionbeat", - Kinesis: events.KinesisRecord{ - Data: []byte(`eyJtZXNzYWdlVHlwZSI6IkRBVEFfTUVTU0FHRSIsIm93bmVyIjoiMDc5NzA5NzYxMTUyIiwibG9n -R3JvdXAiOiJ0ZXN0ZW0iLCJsb2dTdHJlYW0iOiJmb2x5b21hbnkiLCJzdWJzY3JpcHRpb25GaWx0 -ZXJzIjpbIk1pbmRlbiJdLCJsb2dFdmVudHMiOlt7ImlkIjoiMzQ5MzM1ODk4NzM5NzIwNDAzMDgy -ODAzMDIzMTg1MjMxODU5NjA1NTQxODkxNjg4NzMyNDI2MjQiLCJ0aW1lc3RhbXAiOjE1NjY0NzYz -NDcwMDAsIm1lc3NhZ2UiOiJUZXN0IGV2ZW50IDMifSx7ImlkIjoiMzQ5MzM1ODk4NzM5OTQzNDEw -NTM0Nzg4MzI5NDE2NjQ3MjE2Nzg4MjY4Mzc1MzAzNzkyMjMwNDEiLCJ0aW1lc3RhbXAiOjE1NjY0 -NzYzNDcwMDEsIm1lc3NhZ2UiOiJUZXN0IGV2ZW50IDQifSx7ImlkIjoiMzQ5MzM1ODk4NzQwMTY2 -NDE3OTg2NzczNjM1NjQ4MDYyNTczOTcwOTk0ODU4OTE4ODUyMDM0NTgiLCJ0aW1lc3RhbXAiOjE1 -NjY0NzYzNDcwMDIsIm1lc3NhZ2UiOiJUaGlzIG1lc3NhZ2UgYWxzbyBjb250YWlucyBhbiBFcnJv -ciJ9XX0=`), - PartitionKey: "abc123", - SequenceNumber: "12345", - KinesisSchemaVersion: "1.0", - EncryptionType: "test", - }, - }, - }, - } - - events, err := CloudwatchKinesisEvent(request, true, false) - assert.NoError(t, err) - assert.Equal(t, 3, len(events)) - - envelopeFields := mapstr.M{ - "cloud": mapstr.M{ - "provider": "aws", - "region": "us-east-1", - }, - "event": mapstr.M{ - "kind": "event", - }, - "event_id": "1234", - "event_name": "connect", - "event_source": "web", - "event_source_arn": "arn:aws:iam::00000000:role/functionbeat", - "event_version": "1.0", - "aws_region": "us-east-1", - "kinesis_partition_key": "abc123", - "kinesis_schema_version": "1.0", - "kinesis_sequence_number": "12345", - "kinesis_encryption_type": "test", - } - - expectedInnerFields := []mapstr.M{ - mapstr.M{ - "id": "34933589873972040308280302318523185960554189168873242624", - "log_group": "testem", - "log_stream": "folyomany", - "owner": "079709761152", - "message": "Test event 3", - "message_type": "DATA_MESSAGE", - "subscription_filters": []string{ - "Minden", - }, - }, - mapstr.M{ - "id": "34933589873994341053478832941664721678826837530379223041", - "log_group": "testem", - "log_stream": "folyomany", - "owner": "079709761152", - "message": "Test event 4", - "message_type": "DATA_MESSAGE", - "subscription_filters": []string{ - "Minden", - }, - }, - mapstr.M{ - "id": "34933589874016641798677363564806257397099485891885203458", - "log_group": "testem", - "log_stream": "folyomany", - "owner": "079709761152", - "message": "This message also contains an Error", - "message_type": "DATA_MESSAGE", - "subscription_filters": []string{ - "Minden", - }, - }, - } - - for i, expectedFields := range expectedInnerFields { - expectedFields.Update(envelopeFields) - assert.Equal(t, expectedFields, events[i].Fields) - } -} - -func generateKinesisAggregateRecord(numRecords int, valid bool) []byte { - // Heavily based on https://github.com/awslabs/kinesis-aggregation/blob/master/go/deaggregator/deaggregator_test.go - aggRec := &aggRecProto.AggregatedRecord{} - unquotedHeader, err := strconv.Unquote(deaggregator.KplMagicHeader) - if err != nil { - panic(err) - } - aggRecBytes := []byte(unquotedHeader) - partKeyTable := make([]string, 0) - for i := 0; i < numRecords; i++ { - partKey := uint64(i) - hashKey := uint64(i) - r := &aggRecProto.Record{ - ExplicitHashKeyIndex: &hashKey, - Data: []byte(fmt.Sprintf("%s %d", "hello world", i)), - Tags: make([]*aggRecProto.Tag, 0), - } - // This seems to be the only way to trigger the deaggregation module to return an error when needed - if valid { - r.PartitionKeyIndex = &partKey - } - aggRec.Records = append(aggRec.Records, r) - partKeyTable = append(partKeyTable, fmt.Sprintf("%s %d", "partKey", i)) - } - - aggRec.PartitionKeyTable = partKeyTable - data, _ := proto.Marshal(protoimpl.X.ProtoMessageV2Of(aggRec)) - md5Hash := md5.Sum(data) - aggRecBytes = append(aggRecBytes, data...) - aggRecBytes = append(aggRecBytes, md5Hash[:]...) - - return aggRecBytes -} diff --git a/x-pack/functionbeat/provider/aws/cmd/root.go b/x-pack/functionbeat/provider/aws/cmd/root.go deleted file mode 100644 index c8e7ba17d62..00000000000 --- a/x-pack/functionbeat/provider/aws/cmd/root.go +++ /dev/null @@ -1,29 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package cmd - -import ( - "flag" - - "github.com/elastic/beats/v7/libbeat/cfgfile" - "github.com/elastic/beats/v7/x-pack/functionbeat/function/beater" - funcmd "github.com/elastic/beats/v7/x-pack/functionbeat/function/cmd" -) - -// Name of this beat -var Name = "functionbeat" - -// RootCmd to handle functionbeat -var RootCmd *funcmd.FunctionCmd - -func init() { - RootCmd = funcmd.NewFunctionCmd(Name, beater.New) - RootCmd.PersistentFlags().AddGoFlag(flag.CommandLine.Lookup("d")) - cfgfile.AddAllowedBackwardsCompatibleFlag("d") - RootCmd.PersistentFlags().AddGoFlag(flag.CommandLine.Lookup("v")) - cfgfile.AddAllowedBackwardsCompatibleFlag("v") - RootCmd.PersistentFlags().AddGoFlag(flag.CommandLine.Lookup("e")) - cfgfile.AddAllowedBackwardsCompatibleFlag("e") -} diff --git a/x-pack/functionbeat/provider/aws/include/feature.go b/x-pack/functionbeat/provider/aws/include/feature.go deleted file mode 100644 index 99013448439..00000000000 --- a/x-pack/functionbeat/provider/aws/include/feature.go +++ /dev/null @@ -1,37 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package include - -import ( - "github.com/elastic/beats/v7/libbeat/feature" - "github.com/elastic/beats/v7/x-pack/functionbeat/function/provider" - "github.com/elastic/beats/v7/x-pack/functionbeat/provider/aws/aws" -) - -// Bundle exposes the trigger supported by the AWS provider. -var features = provider.Builder( - "aws", - provider.NewDefaultProvider("aws", provider.NewNullCli, provider.NewNullTemplateBuilder), - feature.MakeDetails("AWS Lambda", "listen to events on AWS lambda", feature.Stable), -).AddFunction("cloudwatch_logs", - aws.NewCloudwatchLogs, - aws.CloudwatchLogsDetails(), -).AddFunction("api_gateway_proxy", - aws.NewAPIGatewayProxy, - aws.APIGatewayProxyDetails(), -).AddFunction("kinesis", - aws.NewKinesis, - aws.KinesisDetails(), -).AddFunction("sqs", - aws.NewSQS, - aws.SQSDetails(), -).AddFunction("cloudwatch_logs_kinesis", - aws.NewCloudwatchKinesis, - aws.CloudwatchKinesisDetails(), -).Features() - -func init() { - feature.MustRegister(features...) -} diff --git a/x-pack/functionbeat/provider/aws/main.go b/x-pack/functionbeat/provider/aws/main.go deleted file mode 100644 index 9ee80bb4894..00000000000 --- a/x-pack/functionbeat/provider/aws/main.go +++ /dev/null @@ -1,18 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package main - -import ( - "os" - - "github.com/elastic/beats/v7/x-pack/functionbeat/provider/aws/cmd" - _ "github.com/elastic/beats/v7/x-pack/functionbeat/provider/aws/include" -) - -func main() { - if err := cmd.RootCmd.Execute(); err != nil { - os.Exit(1) - } -} diff --git a/x-pack/functionbeat/provider/aws/main_test.go b/x-pack/functionbeat/provider/aws/main_test.go deleted file mode 100644 index f180fd28275..00000000000 --- a/x-pack/functionbeat/provider/aws/main_test.go +++ /dev/null @@ -1,35 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package main - -// This file is mandatory as otherwise the functionbeat.test binary is not generated correctly. - -import ( - "flag" - "testing" - - "github.com/elastic/beats/v7/libbeat/cfgfile" - "github.com/elastic/beats/v7/x-pack/functionbeat/provider/aws/cmd" -) - -var systemTest *bool - -func init() { - testing.Init() - systemTest = flag.Bool("systemTest", false, "Set to true when running system tests") - - cmd.RootCmd.PersistentFlags().AddGoFlag(flag.CommandLine.Lookup("systemTest")) - cfgfile.AddAllowedBackwardsCompatibleFlag("systemTest") - cmd.RootCmd.PersistentFlags().AddGoFlag(flag.CommandLine.Lookup("test.coverprofile")) - cfgfile.AddAllowedBackwardsCompatibleFlag("test.coverprofile") -} - -// Test started when the test binary is started. Only calls main. -func TestSystem(t *testing.T) { - cfgfile.ConvertFlagsForBackwardsCompatibility() - if *systemTest { - main() - } -} diff --git a/x-pack/functionbeat/provider/local/cmd/root.go b/x-pack/functionbeat/provider/local/cmd/root.go deleted file mode 100644 index 11307a141b1..00000000000 --- a/x-pack/functionbeat/provider/local/cmd/root.go +++ /dev/null @@ -1,20 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package cmd - -import ( - funcmd "github.com/elastic/beats/v7/x-pack/functionbeat/function/cmd" - "github.com/elastic/beats/v7/x-pack/functionbeat/manager/beater" -) - -// Name of this beat -var Name = "functionbeat" - -// RootCmd to handle functionbeat -var RootCmd *funcmd.FunctionCmd - -func init() { - RootCmd = funcmd.NewFunctionCmd(Name, beater.New) -} diff --git a/x-pack/functionbeat/provider/local/include/feature.go b/x-pack/functionbeat/provider/local/include/feature.go deleted file mode 100644 index d5eed566826..00000000000 --- a/x-pack/functionbeat/provider/local/include/feature.go +++ /dev/null @@ -1,14 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package include - -import ( - "github.com/elastic/beats/v7/libbeat/feature" - "github.com/elastic/beats/v7/x-pack/functionbeat/provider/local/local" -) - -func init() { - feature.MustRegister(local.Features...) -} diff --git a/x-pack/functionbeat/provider/local/local/local.go b/x-pack/functionbeat/provider/local/local/local.go deleted file mode 100644 index 76edf380846..00000000000 --- a/x-pack/functionbeat/provider/local/local/local.go +++ /dev/null @@ -1,103 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package local - -import ( - "bufio" - "context" - "os" - "time" - - "github.com/elastic/beats/v7/libbeat/beat" - "github.com/elastic/beats/v7/libbeat/feature" - "github.com/elastic/beats/v7/libbeat/publisher/pipeline" - "github.com/elastic/beats/v7/x-pack/functionbeat/function/provider" - "github.com/elastic/beats/v7/x-pack/functionbeat/function/telemetry" - conf "github.com/elastic/elastic-agent-libs/config" - "github.com/elastic/elastic-agent-libs/mapstr" -) - -const stdinName = "stdin" - -// Features exposes the local provider and the STDIN function. -var Features = provider.Builder( - "local", - provider.NewDefaultProvider("local", provider.NewNullCli, provider.NewNullTemplateBuilder), - feature.MakeDetails("local events", "allows to trigger events locally.", feature.Experimental), -).AddFunction( - stdinName, - NewStdinFunction, - feature.MakeDetails(stdinName, "read events from stdin", feature.Experimental), -).Features() - -// StdinFunction reads events from STIN and terminates when stdin is completed. -type StdinFunction struct{} - -// NewStdinFunction creates a new StdinFunction -func NewStdinFunction( - provider provider.Provider, - functionConfig *conf.C, -) (provider.Function, error) { - return &StdinFunction{}, nil -} - -// Run reads events from the STDIN and send them to the publisher pipeline, will stop reading by -// either by an external signal to stop or by reaching EOF. When EOF is reached functionbeat will shutdown. -func (s *StdinFunction) Run(ctx context.Context, client pipeline.ISyncClient, _ telemetry.T) error { - errChan := make(chan error) - defer close(errChan) - lineChan := make(chan string) - defer close(lineChan) - - // Make the os.Stdin interruptable, the shutdown cleanup will unblock the os.Stdin and the goroutine. - go func(ctx context.Context, lineChan chan string, errChan chan error) { - buf := bufio.NewReader(os.Stdin) - scanner := bufio.NewScanner(buf) - scanner.Split(bufio.ScanLines) - - for scanner.Scan() { - if err := scanner.Err(); err != nil { - errChan <- err - return - } - - select { - case <-ctx.Done(): - return - case lineChan <- scanner.Text(): - } - } - }(ctx, lineChan, errChan) - - for { - select { - case <-ctx.Done(): - return os.Stdin.Close() - case err := <-errChan: - return err - case line := <-lineChan: - event := s.newEvent(line) - err := client.Publish(event) - if err != nil { - return err - } - } - } -} - -func (s *StdinFunction) newEvent(line string) beat.Event { - event := beat.Event{ - Timestamp: time.Now(), - Fields: mapstr.M{ - "message": line, - }, - } - return event -} - -// Name returns the name of the stdin function. -func (s *StdinFunction) Name() string { - return stdinName -} diff --git a/x-pack/functionbeat/provider/local/main.go b/x-pack/functionbeat/provider/local/main.go deleted file mode 100644 index 35284d4a716..00000000000 --- a/x-pack/functionbeat/provider/local/main.go +++ /dev/null @@ -1,18 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package main - -import ( - "os" - - "github.com/elastic/beats/v7/x-pack/functionbeat/provider/local/cmd" - _ "github.com/elastic/beats/v7/x-pack/functionbeat/provider/local/include" // imports features -) - -func main() { - if err := cmd.RootCmd.Execute(); err != nil { - os.Exit(1) - } -} diff --git a/x-pack/functionbeat/provider/local/main_test.go b/x-pack/functionbeat/provider/local/main_test.go deleted file mode 100644 index 7c617b300a6..00000000000 --- a/x-pack/functionbeat/provider/local/main_test.go +++ /dev/null @@ -1,35 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package main - -// This file is mandatory as otherwise the functionbeat.test binary is not generated correctly. - -import ( - "flag" - "testing" - - "github.com/elastic/beats/v7/libbeat/cfgfile" - "github.com/elastic/beats/v7/x-pack/functionbeat/provider/local/cmd" -) - -var systemTest *bool - -func init() { - testing.Init() - systemTest = flag.Bool("systemTest", false, "Set to true when running system tests") - - cmd.RootCmd.PersistentFlags().AddGoFlag(flag.CommandLine.Lookup("systemTest")) - cfgfile.AddAllowedBackwardsCompatibleFlag("systemTest") - cmd.RootCmd.PersistentFlags().AddGoFlag(flag.CommandLine.Lookup("test.coverprofile")) - cfgfile.AddAllowedBackwardsCompatibleFlag("test.coverprofile") -} - -// Test started when the test binary is started. Only calls main. -func TestSystem(t *testing.T) { - cfgfile.ConvertFlagsForBackwardsCompatibility() - if *systemTest { - main() - } -} diff --git a/x-pack/functionbeat/scripts/mage/config.go b/x-pack/functionbeat/scripts/mage/config.go deleted file mode 100644 index 1d3e773d602..00000000000 --- a/x-pack/functionbeat/scripts/mage/config.go +++ /dev/null @@ -1,23 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package mage - -import ( - devtools "github.com/elastic/beats/v7/dev-tools/mage" -) - -// XPackConfigFileParams returns the configuration of sample and reference configuration data. -func XPackConfigFileParams() devtools.ConfigFileParams { - p := devtools.DefaultConfigFileParams() - p.Templates = append(p.Templates, "_meta/config/*.tmpl") - p.ExtraVars = map[string]interface{}{ - "ExcludeConsole": false, - "ExcludeFileOutput": true, - "ExcludeKafka": true, - "ExcludeRedis": true, - "UseDockerMetadataProcessor": false, - } - return p -} diff --git a/x-pack/functionbeat/scripts/mage/providers.go b/x-pack/functionbeat/scripts/mage/providers.go deleted file mode 100644 index d77c1da548d..00000000000 --- a/x-pack/functionbeat/scripts/mage/providers.go +++ /dev/null @@ -1,55 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package mage - -import ( - "fmt" - "os" - "strings" -) - -var ( - availableProviders = []ProviderDetails{ - {Name: "aws", Buildable: true, GOOS: "linux", GOARCH: "amd64"}, - } -) - -// ProviderDetails stores information about the available cloud providers. -type ProviderDetails struct { - Name string - Buildable bool - GOOS string - GOARCH string -} - -// SelectedProviders is the list of selected providers -// Can be configured by setting PROVIDERS enviroment variable. -func SelectedProviders() ([]ProviderDetails, error) { - providers := os.Getenv("PROVIDERS") - if len(providers) == 0 { - return availableProviders, nil - } - - names := strings.Split(providers, ",") - providerDetails := make([]ProviderDetails, len(names)) - for i, name := range names { - p, err := findProviderDetails(name) - if err != nil { - return nil, err - } - providerDetails[i] = p - } - return providerDetails, nil -} - -func findProviderDetails(name string) (ProviderDetails, error) { - for _, p := range availableProviders { - if p.Name == name { - return p, nil - } - } - - return ProviderDetails{}, fmt.Errorf("no such provider") -} diff --git a/x-pack/functionbeat/scripts/mage/update.go b/x-pack/functionbeat/scripts/mage/update.go deleted file mode 100644 index 468bdafbe0f..00000000000 --- a/x-pack/functionbeat/scripts/mage/update.go +++ /dev/null @@ -1,48 +0,0 @@ -// Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one -// or more contributor license agreements. Licensed under the Elastic License; -// you may not use this file except in compliance with the Elastic License. - -package mage - -import ( - "github.com/magefile/mage/mg" - - devtools "github.com/elastic/beats/v7/dev-tools/mage" -) - -// Update target namespace. -type Update mg.Namespace - -// Aliases stores aliases for the targets. -var Aliases = map[string]interface{}{ - "update": Update.All, -} - -// All updates all generated content. -func (Update) All() { - mg.Deps(Update.Fields, Update.IncludeFields, Update.Config, Update.FieldDocs) -} - -// Config generates both the short and reference configs. -func (Update) Config() error { - return devtools.Config(devtools.ShortConfigType|devtools.ReferenceConfigType, XPackConfigFileParams(), ".") -} - -// Fields generates a fields.yml for the Beat. -func (Update) Fields() error { - return devtools.GenerateFieldsYAML() -} - -// FieldDocs collects all fields by provider and generates documentation for them. -func (Update) FieldDocs() error { - mg.Deps(Update.Fields) - - return devtools.Docs.FieldDocs("fields.yml") -} - -// IncludeFields generates include/fields.go by provider. -func (Update) IncludeFields() error { - mg.Deps(Update.Fields) - - return devtools.GenerateAllInOneFieldsGo() -} diff --git a/x-pack/functionbeat/tests/system/config/functionbeat.yml.j2 b/x-pack/functionbeat/tests/system/config/functionbeat.yml.j2 deleted file mode 100644 index 64a69bceab9..00000000000 --- a/x-pack/functionbeat/tests/system/config/functionbeat.yml.j2 +++ /dev/null @@ -1,101 +0,0 @@ -################### Beat Configuration ######################### -{% if local %} -functionbeat.provider.local: - functions: - - type: stdin - enabled: true -{% endif %} - -{% if cloudwatch %} -functionbeat.provider.aws.endpoint: {{ cloudwatch.endpoint | default("s3.amazonaws.com") }} -functionbeat.provider.aws.deploy_bucket: {{ cloudwatch.bucket | default("functionbeat-deploy") }} -functionbeat.provider.aws.functions: - - name: {{ cloudwatch.name }} - enabled: true - type: cloudwatch_logs - description: "lambda function for cloudwatch logs" - {% if cloudwatch.role %}role: {{ cloudwatch.role }}{% endif %} - {% if cloudwatch.virtual_private_cloud %} - virtual_private_cloud: - security_group_ids: {{ cloudwatch.virtual_private_cloud.security_group_ids }} - subnet_ids: {{ cloudwatch.virtual_private_cloud.subnet_ids }} - {% endif %} - - triggers: - - log_group_name: {{ cloudwatch.log_group | default("/aws/lambda/functionbeat-cloudwatch") }} -{% endif %} - -############################# Output ########################################## - -# Configure what outputs to use when sending the data collected by the beat. -# You can enable one or multiple outputs by setting enabled option to true. -output: - - ### File as output - file: - # Enabling file output - enabled: true - - # Path to the directory where to save the generated files. The option is mandatory. - path: {{ output_file_path|default(beat.working_dir + "/output") }} - - - # Name of the generated files. The default is `functionbeat` and it generates - # files: `functionbeat`, `functionbeat.1`, `functionbeat.2`, etc. - filename: {{ output_file_filename|default("functionbeat") }} - - # Maximum size in kilobytes of each file. When this size is reached, the files are - # rotated. The default value is 10 MB. - #rotate_every_kb: 10000 - - # Maximum number of files under path. When this number of files is reached, the - # oldest file is deleted and the rest are shifted from last to first. The default - # is 7 files. - #number_of_files: 7 - - - -############################# Beat ######################################### - -# The name of the shipper that publishes the network data. It can be used to group -# all the transactions sent by a single shipper in the web interface. -# If this options is not defined, the hostname is used. -#name: - -# The tags of the shipper are included in their own field with each -# transaction published. Tags make it easy to group servers by different -# logical properties. -#tags: ["service-X", "web-tier"] - - - -############################# Logging ######################################### - -#logging: - # Send all logging output to syslog. On Windows default is false, otherwise - # default is true. - #to_syslog: true - - # Write all logging output to files. Beats automatically rotate files if configurable - # limit is reached. - #to_files: false - - # Enable debug output for selected components. - #selectors: [] - - # Set log level - #level: error - - #files: - # The directory where the log files will written to. - #path: /var/log/functionbeat - - # The name of the files where the logs are written to. - #name: functionbeat - - # Configure log file size limit. If limit is reached, log file will be - # automatically rotated - #rotateeverybytes: 10485760 # = 10MB - - # Number of rotated log files to keep. Oldest files will be deleted first. - #keepfiles: 7 diff --git a/x-pack/functionbeat/tests/system/functionbeat.py b/x-pack/functionbeat/tests/system/functionbeat.py deleted file mode 100644 index 24327363aef..00000000000 --- a/x-pack/functionbeat/tests/system/functionbeat.py +++ /dev/null @@ -1,12 +0,0 @@ -import os -import sys -from beat.beat import TestCase - - -class BaseTest(TestCase): - - @classmethod - def setUpClass(self): - self.beat_name = "functionbeat" - self.beat_path = os.path.abspath(os.path.join(os.path.dirname(__file__), "../../")) - super(BaseTest, self).setUpClass() diff --git a/x-pack/functionbeat/tests/system/requirements.txt b/x-pack/functionbeat/tests/system/requirements.txt deleted file mode 100644 index c2399b66f80..00000000000 --- a/x-pack/functionbeat/tests/system/requirements.txt +++ /dev/null @@ -1 +0,0 @@ -protobuf==3.19.5 #Temporary change because of protobuf new version bug: https://github.com/protocolbuffers/protobuf/issues/10051 diff --git a/x-pack/functionbeat/tests/system/test_base.py b/x-pack/functionbeat/tests/system/test_base.py deleted file mode 100644 index 39a1051f806..00000000000 --- a/x-pack/functionbeat/tests/system/test_base.py +++ /dev/null @@ -1,118 +0,0 @@ -from functionbeat import BaseTest - -import json -import os -import unittest -from beat import common_tests - - -class Test(BaseTest, common_tests.TestExportsMixin): - @unittest.skip("temporarily disabled") - def test_base(self): - """ - Basic test with exiting Functionbeat normally - """ - self.render_config_template( - path=os.path.abspath(self.working_dir) + "/log/*", - local=True, - ) - - functionbeat_proc = self.start_beat() - self.wait_until(lambda: self.log_contains("functionbeat is running")) - exit_code = functionbeat_proc.kill_and_wait() - assert exit_code == 0 - - def test_export_function(self): - """ - Test if the template can be exported - """ - - function_name = "testcloudwatchlogs" - bucket_name = "my-bucket-name" - fnb_name = "fnb" + function_name - role = "arn:aws:iam::123456789012:role/MyFunction" - security_group_ids = ["sg-ABCDEFGHIJKL"] - subnet_ids = ["subnet-ABCDEFGHIJKL"] - log_group = "/aws/lambda/functionbeat-cloudwatch" - - self._generate_dummy_binary_for_template_checksum() - - self.render_config_template( - path=os.path.abspath(self.working_dir) + "/log/*", - cloudwatch={ - "name": function_name, - "bucket": bucket_name, - "role": role, - "virtual_private_cloud": { - "security_group_ids": security_group_ids, - "subnet_ids": subnet_ids, - }, - "log_group": log_group, - }, - ) - functionbeat_proc = self.start_beat( - logging_args=["-d", "*"], - extra_args=["export", "function", function_name] - ) - - self.wait_until(lambda: self.log_contains("PASS")) - functionbeat_proc.check_wait() - - function_template = self._get_generated_function_template() - function_properties = function_template["Resources"][fnb_name]["Properties"] - - assert function_properties["FunctionName"] == function_name - assert function_properties["Code"]["S3Bucket"] == bucket_name - assert function_properties["Role"] == role - assert function_properties["VpcConfig"]["SecurityGroupIds"] == security_group_ids - assert function_properties["VpcConfig"]["SubnetIds"] == subnet_ids - - def test_export_function_invalid_conf(self): - """ - Test if invalid configuration is exportable - """ - function_name = "INVALID_$_FUNCTION_$_NAME" - bucket_name = "my-bucket-name" - - self._generate_dummy_binary_for_template_checksum() - - self.render_config_template( - path=os.path.abspath(self.working_dir) + "/log/*", - cloudwatch={ - "name": function_name, - "bucket": bucket_name, - }, - ) - functionbeat_proc = self.start_beat( - logging_args=["-d", "*"], - extra_args=["export", "function", function_name] - ) - - self.wait_until( - lambda: self.log_contains("error while finding enabled functions: invalid name: '{}'".format(function_name)) - ) - - exit_code = functionbeat_proc.kill_and_wait() - assert exit_code != 0 - - def _generate_dummy_binary_for_template_checksum(self): - fnbeat_pkg = os.path.join("pkg", "functionbeat") - fnbeat_aws_pkg = os.path.join("pkg", "functionbeat-aws") - bins_to_gen = [fnbeat_pkg, fnbeat_aws_pkg] - - if not os.path.exists("pkg"): - os.mkdir("pkg") - - for fb in bins_to_gen: - if os.path.exists(fb): - continue - with open(fb, "w") as f: - f.write("my dummy functionbeat binary\n") - - def _get_generated_function_template(self): - log = self.get_log() - # Trim the extra output from the Go test wrapper (like PASS/FAIL and - # coverage information). - log = log[:log.rindex('}') + 1] - function_template = json.loads(log) - return function_template diff --git a/x-pack/libbeat/docs/aws-credentials-config.asciidoc b/x-pack/libbeat/docs/aws-credentials-config.asciidoc index 423e241f896..451980c28b7 100644 --- a/x-pack/libbeat/docs/aws-credentials-config.asciidoc +++ b/x-pack/libbeat/docs/aws-credentials-config.asciidoc @@ -120,10 +120,6 @@ ifeval::["{beatname_lc}"=="metricbeat"] include::../../../metricbeat/docs/aws-credentials-examples.asciidoc[] endif::[] -ifeval::["{beatname_lc}"=="functionbeat"] -include::../../../filebeat/docs/aws-credentials-examples.asciidoc[] -endif::[] - [float] ==== AWS Credentials Types There are two different types of AWS credentials can be used: