The integration test tool for Apache SkyWalking, including Mock OAP server and trace validator.

Clone this repo:
  1. 8f1efab Remove authors in source ccodes (#18) by kezhenxu94 · 6 days ago master
  2. 08f6fc9 Fix miss `%s` bug (#17) by dagmom · 2 weeks ago
  3. 3c9d709 Add maven wrapper to ease the build in other language agent (#16) by kezhenxu94 · 5 weeks ago
  4. ed896e0 support multiple segment analyzer in rest (#15) by mrproliu · 9 weeks ago
  5. da281e9 fix missing skip analysis field (#14) by mrproliu · 3 months ago

Apache SkyWalking Agent Test Tool Suite

Twitter Follow

CI

SkyWalking Agent Test Tool is a tremendously useful test tools suite in a wide variety of languages of Agent. Includes mock collector and validator. The mock collector is a SkyWalking receiver, like OAP server.

The mock collector is responsible for mocking the SkyWalking OAP receiver to collect data from the agent. It receives data from agent through GRPC and HTTP REST API(in plan). And then it can be downloaded by Http API that the mock collector collected(service registered, instance registered, and segments). Eventually, validate the file downloaded from mock collector by using SkyWalking Validator.

Apache SkyWalking Mock Collector

Requirement

  1. JDK 1.8+
  2. Maven

How to install

The mock collector is written by pure-Java. It compiles and packages through Maven.

mvn package -DskipTests
unzip ./dist/mock-collector.tar.gz -d ./mock-collector
cd ./mock-collector
bash ./bin/collector-startup.sh

after above steps, we can check whether the mock collector is available through HTTP API. To visit http://localhost:12800/healthCheck and get the response with success in the body of content.

Finally, To visit follow URL to download the data as yaml file, which can be used by SkyWalking Validator Tool.

http://localhost:12800/receiveData

How to config on agent

We can modify the configurations of agent in ./config/agent.conf, as follows

# Backend service addresses.
collector.backend_service=${SW_AGENT_COLLECTOR_BACKEND_SERVICES:127.0.0.1:19876}

or specify the jvm arguments like:

# Backend service addresses.
-DSW_AGENT_COLLECTOR_BACKEND_SERVICES=127.0.0.1:19876

Data validation in Mock Collector

Currently, we integration SkyWalking Validator Tool in Mock Collector. We can post the expectedData.yaml to /dataValidate after agent reported.

Apache SkyWalking Validator Tool

Validator Tool is a data validating tool. It is responsible for validating the expected data with actual data.

java -jar \
    -Xmx256m -Xms256m \
    -DcaseName="case_name" \
    -DtestCasePath=/path/to/download-folder \
    ${TOOLS_HOME}/skywalking-validator-tools.jar

NOTICE: the expected data have to call expectedData.yaml, and the actual data must name as actualData.yaml. And these are in the same directory, /path/to/download-folder. JVM argument caseName just for show in the log.

The format and documentation of expectedData.yaml could be found in SkyWalking plugin test doc

Contact Us

  • Mail list: dev@skywalking.apache.org. Mail to dev-subscribe@skywalking.apache.org, follow the reply to subscribe the mail list.
  • Join skywalking channel at Apache Slack. If the link is not working, find the latest one at Apache INFRA WIKI.
  • QQ Group: 392443393(2000/2000, not available), 901167865(available)

License

Apache 2.0