Skip to content
cccskills
FreePublished on GitHubEnglish overview

test

Run SkyWalking unit tests, integration tests, or the separate slow integration test using commands aligned with CI. Select a test group or module, and use the documented naming and tagging conventions to understand which tests run in each phase.

OriginalShow the original description

Run unit tests, integration tests, or slow integration tests matching CI. Use to validate changes before submitting a PR.

apache/skywalking24,978 stars(GitHub 24,978 + cccskills 0)

Run score Not tested

See how to install

Good for

  • Running unit tests before submitting a change
  • Running integration tests while excluding slow cases
  • Executing tests for one Maven module
  • Running the slow Elasticsearch or OpenSearch integration test

Overview

What it does

This skill explains how to run SkyWalking unit tests, integration tests, and slow integration tests with commands aligned with CI. With no argument or unit, run unit tests; choose integration for integration tests that exclude slow tests, or slow for the slow test group. You can also name a module to run tests for that module. The guide covers test naming patterns, Maven phases, and the @Tag("slow") classification so you can tell which tests each command includes.

When it helps

Use it to validate changes with the same test groups used by CI before submitting a PR. It is also useful when you want to check one module before running the full suite, or run Elasticsearch/OpenSearch integration tests that are excluded from the regular integration job.

Example requests

  • “Run the unit tests to check my changes.”
  • “Run integration tests without the slow tests.”
  • “Show me the integration test command for this module.”

Notes

The commands use Maven Wrapper. CI test groups have different JDK and operating system conditions. The guide advises investigating local failures instead of relying on CI retries.

This overview was written by AI (OpenAI Codex) from the public SKILL.md. Check the original below for the exact behavior.

Document check

AI checked the SKILL.md for operations that need care and for setup requirements. The score comes only from actually running the skill (hands-on test).

SafetyAre sending data, deleting files, and running commands disclosed?
AGoodCommands define test scope, and the guide advises investigating failures.
Easy setupDoes it need few tools or API keys, and are they documented?
BPartly lackingIt uses Maven Wrapper and lists CI JDK/OS conditions, but no setup steps.

Not counted in the score. Rated by AI (OpenAI Codex) as of Oct 29, 2026. Treat it as a guide and read the original before installing.

Disagree? Request a re-evaluation

Tell us which point is wrong and why. No login needed. We will check it against the SKILL.md, redo the evaluation, and show the result here.

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

Files included (1)

  • SKILL.md2.4 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Tests

Run tests matching CI configuration.

Commands by argument

unit or no argument — unit tests

./mvnw clean test -q -B -D"checkstyle.skip"

CI runs this on:

  • JDK 11: ubuntu, macOS, Windows
  • JDK 17, 21, 25: ubuntu only

integration — integration tests (excludes slow)

./mvnw -B clean integration-test -Dcheckstyle.skip -DskipUTs=true -DexcludedGroups=slow

CI runs this on JDK 11, 17, 21, 25 (ubuntu only).

slow — slow integration tests

./mvnw -B clean integration-test -Dcheckstyle.skip -DskipUTs=true \
  -Dit.test=org.apache.skywalking.library.elasticsearch.ElasticSearchIT \
  -Dfailsafe.failIfNoSpecifiedTests=false

CI runs on JDK 11 (ubuntu only). Currently only ElasticSearch/OpenSearch IT is in the slow matrix.

Module name — single module tests

# Unit tests for a specific module
./mvnw clean test -pl oap-server/analyzer/<module-name> -D"checkstyle.skip"

# Integration tests for a specific module
./mvnw -B clean integration-test -pl oap-server/analyzer/<module-name> -Dcheckstyle.skip -DskipUTs=true

Test frameworks

  • JUnit 5 (org.junit.jupiter)
  • Mockito for mocking
  • AssertJ for assertions
  • PowerMock for reflection utilities

Test naming conventions

TypePatternMaven phase
Unit tests*Test.javatest
Integration testsIT*.java or *IT.javaintegration-test

Slow test tagging

Tests tagged with @Tag("slow") are excluded from the normal integration-test job and run separately in the slow-integration-test job. Use this tag for tests that spin up external services (Elasticsearch, etc.) and take significant time.

CI retry behavior

All three CI jobs retry on failure (run the same command twice with ||). This handles flaky tests but masks intermittent issues — if a test fails locally, investigate rather than relying on retries.

CI reference

CI workflow: .github/workflows/skywalking.yaml

JobJDKOSTimeout
unit-test11 (3 OS) + 17, 21, 25 (ubuntu)ubuntu, macOS, Windows30 min
integration-test11, 17, 21, 25ubuntu60 min
slow-integration-test11ubuntu60 min

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

ci-e2e-debug

FreeSummary

Use this skill to investigate failed end-to-end tests in GitHub Actions. It downloads the run’s log artifacts, checks OAP and other component logs for errors, and summarizes the likely root cause, including failures in standalone test tools.

  • Investigating a failed GitHub Actions E2E run
  • Checking OAP and component logs for errors
  • Tracing failures in standalone test tools
apache/skywalking25KUpdated Oct 29, 2026

compile

FreeSummary

Validate SkyWalking OAP changes by building the backend or full project and running Javadoc and Checkstyle checks. Choose commands for a full CI-style build, a faster backend build, one check, or a single module before submitting a pull request.

  • Running a full build before a PR
  • Checking Javadoc output and errors
  • Building one backend module
apache/skywalking25KUpdated Oct 29, 2026

generate-classes

FreeSummary

Compile SkyWalking DSL scripts for MAL, OAL, LAL, or Hierarchy and save the generated .class files for inspection. Choose one DSL or generate classes for all four, then locate the output and use javap to examine bytecode.

  • Inspecting classes generated from MAL expressions
  • Examining OAL metrics or dispatcher bytecode
  • Generating LAL or Hierarchy classes for debugging
apache/skywalking25KUpdated Oct 29, 2026

gh-pull-request

FreeSummary

Prepare a pull request branch by running the documented build, style, license-header, and Java import checks, then committing and pushing the changes. If the branch has no pull request yet, create one using the project template.

  • Preparing checked changes for a pull request
  • Pushing commits from a feature branch
  • Creating a pull request from the current branch
apache/skywalking25KUpdated Oct 29, 2026

license

FreeSummary

Check whether source files carry the required Apache 2.0 headers and whether the dependency license file matches current dependencies. Use the provided commands to fix headers or regenerate the license list, then review any changes before submitting a pull request.

  • Checking Apache license headers before a PR
  • Fixing missing or invalid source headers
  • Reviewing dependency license changes
apache/skywalking25KUpdated Oct 29, 2026

Plan how to add a monitoring target or layer to SkyWalking OAP. The guide maps signals such as metrics, logs, and spans to extension points, and identifies related layer registration, UI templates, documentation, and local verification work.

  • Planning a new SkyWalking monitoring layer
  • Choosing an extension point for metrics or logs
  • Identifying UI and documentation updates
apache/skywalking25KUpdated Oct 29, 2026

See all skills by apache

Report a problem with this skill