Skip to content

[docs-patrol] Update integration testing docs for TestMain auto-build #50168

@github-actions

Description

@github-actions

Recent code changes in the repository have introduced documentation drift. The following changes need corresponding documentation updates.

Changes Requiring Documentation Updates

1. Go integration tests now auto-build test binaries via TestMainWithBuild, but docs still require mage buildSystemTestBinary

Commit(s):

What changed:

  • filebeat/magefile.go marks BuildSystemTestBinary as deprecated for Go integration tests and prints:
    • "The test binary is now built automatically via TestMain."
  • Go integration tests now call integration.TestMainWithBuild(m, "filebeat") in filebeat/tests/integration/integration_test.go.
  • libbeat/tests/integration/framework.go implements TestMainWithBuild and performs testbin.Build(...) automatically before running tests.

Documentation impact:

  • docs/extend/testing.md still presents mage buildSystemTestBinary as a required step for Go integration tests (# Build the test binary before go test ... -tags integration).
  • docs/extend/testing.md also states: To create the testing binary run mage buildSystemTestBinary.
  • filebeat/input/journald/README.md still instructs manual test flow with mage buildSystemTestBinary before the Go integration test command.

These instructions are now outdated for Go integration tests and should be updated to avoid unnecessary/incorrect setup steps.

Suggested Actions

  • Update docs/extend/testing.md Go integration section to state that test binaries are auto-built via TestMainWithBuild.
  • Clarify in docs/extend/testing.md that mage buildSystemTestBinary is only required for Python system-test workflows (if applicable), not Go integration tests.
  • Update filebeat/input/journald/README.md manual integration-test instructions to remove (or explicitly re-scope) the mage buildSystemTestBinary prerequisite for Go integration tests.

Note

🔒 Integrity filter blocked 96 items

The following items were blocked because they don't meet the GitHub integrity level.

  • #43508 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
  • #44537 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
  • #43006 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
  • #50033 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
  • #40503 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
  • #49986 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
  • #50112 search_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
  • #50111 search_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
  • #50113 search_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
  • #50142 search_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
  • #49796 search_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
  • #49850 search_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
  • #49849 search_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
  • #49848 search_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
  • #49503 search_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
  • #49870 search_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
  • ... and 80 more items

To allow these resources, lower min-integrity in your GitHub frontmatter:

tools:
  github:
    min-integrity: approved  # merged | approved | unapproved | none

What is this? | From workflow: Docs Patrol

Give us feedback! React with 🚀 if perfect, 👍 if helpful, 👎 if not.

  • expires on Apr 23, 2026, 2:53 PM UTC

Metadata

Metadata

Assignees

No one assigned

    Labels

    needs_teamIndicates that the issue/PR needs a Team:* label

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions