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
.
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
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
Currently, we integration SkyWalking Validator Tool in Mock Collector. We can post the expectedData.yaml
to /dataValidate
after agent reported.
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
. These files save all the segment and meter data, and 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
dev-subscribe@skywalking.apache.org
, follow the reply to subscribe the mail list.skywalking
channel at Apache Slack. If the link is not working, find the latest one at Apache INFRA WIKI.Apache 2.0