Skip to content

[BeyondTrust EPM] Initial release of BeyondTrust EPM#20010

Open
akshraj-crest wants to merge 5 commits into
elastic:mainfrom
akshraj-crest:beyondtrust_epm-0.1.0
Open

[BeyondTrust EPM] Initial release of BeyondTrust EPM#20010
akshraj-crest wants to merge 5 commits into
elastic:mainfrom
akshraj-crest:beyondtrust_epm-0.1.0

Conversation

@akshraj-crest

@akshraj-crest akshraj-crest commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Proposed commit message

The initial release includes audit and event data stream, associated dashboard
and visualizations.

BeyondTrust EPM fields are mapped to their corresponding ECS fields where possible.

Test samples were derived from product schema's
[Audit Product Schema](https://docs.beyondtrust.com/epm-wm/v25.1/reference/get_v3-activityaudits-details)
[Event Product Schema](https://docs.beyondtrust.com/epm-wm/reference/get_v3-events-search)

The entries in fields.yml are generated through an automation tool that uses the field mapping sheet as input.

Checklist

  • I have reviewed tips for building integrations and this pull request is aligned with them.
  • I have verified that all data streams collect metrics or logs.
  • I have added an entry to my package's changelog.yml file.
  • I have verified that Kibana version constraints are current according to guidelines.
  • I have verified that any added dashboard complies with Kibana's Dashboard good practices

How to test this PR locally

To test the BeyondTrust EPM package:

  • Clone integrations repo.
  • Install elastic package locally.
  • Start elastic stack using elastic-package.
  • Move to integrations/packages/beyondtrust_epm directory.
  • Run the following command to run tests.

elastic-package test

Run asset tests for the package
2026/07/07 16:08:00  INFO elastic-package v0.125.1 version-hash 111636ab (build time: 2026-07-03T17:56:06+05:30)
2026/07/07 16:08:00  INFO elastic-stack: 8.18.0
--- Test results for package: beyondtrust_epm - START ---
╭─────────────────┬─────────────┬───────────┬──────────────────────────────────────────────────────────────────────────┬────────┬──────────────╮
│ PACKAGE         │ DATA STREAM │ TEST TYPE │ TEST NAME                                                                │ RESULT │ TIME ELAPSED │
├─────────────────┼─────────────┼───────────┼──────────────────────────────────────────────────────────────────────────┼────────┼──────────────┤
│ beyondtrust_epm │             │ asset     │ dashboard beyondtrust_epm-20f84912-15d7-4fa5-94eb-a2c945a6d477 is loaded │ PASS   │        2.2µs │
│ beyondtrust_epm │             │ asset     │ dashboard beyondtrust_epm-2ed6e850-d14a-4504-940c-49eb04afe9b8 is loaded │ PASS   │        357ns │
│ beyondtrust_epm │ audit       │ asset     │ index_template logs-beyondtrust_epm.audit is loaded                      │ PASS   │        654ns │
│ beyondtrust_epm │ audit       │ asset     │ ingest_pipeline logs-beyondtrust_epm.audit-0.1.0 is loaded               │ PASS   │        241ns │
│ beyondtrust_epm │ event       │ asset     │ index_template logs-beyondtrust_epm.event is loaded                      │ PASS   │        313ns │
│ beyondtrust_epm │ event       │ asset     │ ingest_pipeline logs-beyondtrust_epm.event-0.1.0 is loaded               │ PASS   │        174ns │
╰─────────────────┴─────────────┴───────────┴──────────────────────────────────────────────────────────────────────────┴────────┴──────────────╯
--- Test results for package: beyondtrust_epm - END   ---
Done
Run pipeline tests for the package
2026/07/07 16:08:10  INFO elastic-package v0.125.1 version-hash 111636ab (build time: 2026-07-03T17:56:06+05:30)
2026/07/07 16:08:10  INFO elastic-stack: 8.18.0
--- Test results for package: beyondtrust_epm - START ---
╭─────────────────┬─────────────┬───────────┬───────────────────────────────────────────┬────────┬──────────────╮
│ PACKAGE         │ DATA STREAM │ TEST TYPE │ TEST NAME                                 │ RESULT │ TIME ELAPSED │
├─────────────────┼─────────────┼───────────┼───────────────────────────────────────────┼────────┼──────────────┤
│ beyondtrust_epm │ audit       │ pipeline  │ (ingest pipeline warnings test-audit.log) │ PASS   │ 1.869522859s │
│ beyondtrust_epm │ audit       │ pipeline  │ test-audit.log                            │ PASS   │ 1.140149276s │
│ beyondtrust_epm │ event       │ pipeline  │ (ingest pipeline warnings test-event.log) │ PASS   │ 973.607599ms │
│ beyondtrust_epm │ event       │ pipeline  │ test-event.log                            │ PASS   │ 8.916383072s │
╰─────────────────┴─────────────┴───────────┴───────────────────────────────────────────┴────────┴──────────────╯
--- Test results for package: beyondtrust_epm - END   ---
Done
Run policy tests for the package
2026/07/07 16:08:27  INFO elastic-package v0.125.1 version-hash 111636ab (build time: 2026-07-03T17:56:06+05:30)
2026/07/07 16:08:27  INFO elastic-stack: 8.18.0
--- Test results for package: beyondtrust_epm - START ---
No test results
--- Test results for package: beyondtrust_epm - END   ---
Done
Run script tests for the package
PKG beyondtrust_epm
[no test files]
--- Test results for package: beyondtrust_epm - START ---
No test results
--- Test results for package: beyondtrust_epm - END   ---
Done
Run static tests for the package
2026/07/07 16:08:27  INFO elastic-package v0.125.1 version-hash 111636ab (build time: 2026-07-03T17:56:06+05:30)
--- Test results for package: beyondtrust_epm - START ---
╭─────────────────┬─────────────┬───────────┬──────────────────────────┬────────┬──────────────╮
│ PACKAGE         │ DATA STREAM │ TEST TYPE │ TEST NAME                │ RESULT │ TIME ELAPSED │
├─────────────────┼─────────────┼───────────┼──────────────────────────┼────────┼──────────────┤
│ beyondtrust_epm │ audit       │ static    │ Verify sample_event.json │ PASS   │ 339.311386ms │
│ beyondtrust_epm │ event       │ static    │ Verify sample_event.json │ PASS   │ 3.388203354s │
╰─────────────────┴─────────────┴───────────┴──────────────────────────┴────────┴──────────────╯
--- Test results for package: beyondtrust_epm - END   ---
Done
Run system tests for the package
2026/07/07 16:08:32  INFO elastic-package v0.125.1 version-hash 111636ab (build time: 2026-07-03T17:56:06+05:30)
2026/07/07 16:08:32  INFO elastic-stack: 8.18.0
2026/07/07 16:08:32  INFO Installing package...
2026/07/07 16:08:36  INFO Running test for data_stream "audit" with configuration 'cel'
2026/07/07 16:08:44  INFO Setting up independent Elastic Agent...
2026/07/07 16:08:58  INFO Setting up service...
2026/07/07 16:09:44  INFO Validating test case...
2026/07/07 16:09:47  INFO Tearing down service...
2026/07/07 16:09:49  INFO Write container logs to file: /root/integrations/build/container-logs/beyondtrust_epm-1783420789442170782.log
2026/07/07 16:09:52  INFO Tearing down agent...
2026/07/07 16:09:54  INFO Write container logs to file: /root/integrations/build/container-logs/elastic-agent-1783420794052674820.log
2026/07/07 16:10:07  INFO Running test for data_stream "audit" with configuration 'aws'
2026/07/07 16:10:18  INFO Setting up independent Elastic Agent...
2026/07/07 16:10:29  INFO Setting up service...
2026/07/07 16:16:07  INFO Validating test case...
2026/07/07 16:16:09  INFO Tearing down service...
2026/07/07 16:17:47  INFO Write container logs to file: /root/integrations/build/container-logs/beyondtrust_epm-1783421267383094162.log
2026/07/07 16:17:50  INFO Tearing down agent...
2026/07/07 16:17:51  INFO Write container logs to file: /root/integrations/build/container-logs/elastic-agent-1783421271745524798.log
2026/07/07 16:18:04  INFO Running test for data_stream "event" with configuration 'cel'
2026/07/07 16:18:10  INFO Setting up independent Elastic Agent...
2026/07/07 16:18:29  INFO Setting up service...
2026/07/07 16:19:05  INFO Validating test case...
2026/07/07 16:19:08  INFO Tearing down service...
2026/07/07 16:19:09  INFO Write container logs to file: /root/integrations/build/container-logs/beyondtrust_epm-1783421349940404132.log
2026/07/07 16:19:13  INFO Tearing down agent...
2026/07/07 16:19:14  INFO Write container logs to file: /root/integrations/build/container-logs/elastic-agent-1783421354116522078.log
2026/07/07 16:19:26  INFO Running test for data_stream "event" with configuration 'aws'
2026/07/07 16:19:36  INFO Setting up independent Elastic Agent...
2026/07/07 16:19:48  INFO Setting up service...
2026/07/07 16:22:19  INFO Validating test case...
2026/07/07 16:22:48  INFO Tearing down service...
2026/07/07 16:24:30  INFO Write container logs to file: /root/integrations/build/container-logs/beyondtrust_epm-1783421670751786535.log
2026/07/07 16:24:34  INFO Tearing down agent...
2026/07/07 16:24:34  INFO Write container logs to file: /root/integrations/build/container-logs/elastic-agent-1783421674835149607.log
2026/07/07 16:24:53  INFO Uninstalling package...
--- Test results for package: beyondtrust_epm - START ---
╭─────────────────┬─────────────┬───────────┬───────────┬────────┬─────────────────╮
│ PACKAGE         │ DATA STREAM │ TEST TYPE │ TEST NAME │ RESULT │    TIME ELAPSED │
├─────────────────┼─────────────┼───────────┼───────────┼────────┼─────────────────┤
│ beyondtrust_epm │ audit       │ system    │ aws       │ PASS   │  6m1.295212123s │
│ beyondtrust_epm │ audit       │ system    │ cel       │ PASS   │ 1m10.902049842s │
│ beyondtrust_epm │ event       │ system    │ aws       │ PASS   │ 3m22.373884121s │
│ beyondtrust_epm │ event       │ system    │ cel       │ PASS   │  1m4.055073279s │
╰─────────────────┴─────────────┴───────────┴───────────┴────────┴─────────────────╯
--- Test results for package: beyondtrust_epm - END   ---
Done

Related issues

Screenshots

Screenshot 2026-04-29 195551 Screenshot 2026-04-29 195611

Note: This integration follows a phased development process where individual data streams were reviewed and merged into a feature branch through separate PRs:

All PR's have been reviewed and merged in this feature branch, which is now ready for integration into the main branch.

The initial release includes audit data stream, associated dashboard
and visualizations.

BeyondTrust EPM fields are mapped to their corresponding ECS fields where possible.

Test samples were derived from live data samples, which were subsequently
sanitized.
…point_arn, move deploy files (elastic#19465)

Remove the preserve_duplicate_custom_fields configuration parameter
from both the CEL and aws-s3 input types. The ingest pipeline now
unconditionally removes custom fields that duplicate ECS-mapped
values instead of gating the removal on a tag.

Expose the access_point_arn option in the aws-s3 section of the
audit manifest. The stream template already referenced this
variable but it was never declared as a config parameter, so users
could not set it.

Move _dev/deploy/ from the package root into data_stream/audit/
so the test infrastructure sits alongside the data stream it
exercises.
The initial release includes event data stream, associated dashboard
and visualizations.

BeyondTrust EPM fields are mapped to their corresponding ECS fields where possible.

Test samples were derived from [product schema](https://docs.beyondtrust.com/epm-wm/reference/get_v3-events-search)

The entries in fields.yml are generated through an automation tool that uses the field mapping sheet as input.
@elastic-vault-github-plugin-prod

Copy link
Copy Markdown

Reviewers

Buildkite won't run for external contributors automatically; you need to add a comment:

  • /test : will kick off a build in Buildkite.

NOTE: https://github.com/elastic/integrations/blob/main/.buildkite/pull-requests.json contains all those details.

@akshraj-crest akshraj-crest marked this pull request as ready for review July 7, 2026 10:58
@akshraj-crest akshraj-crest requested a review from a team as a code owner July 7, 2026 10:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant