You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: docs/en/contribution/release-java-agent.md
+4-4
Original file line number
Diff line number
Diff line change
@@ -50,9 +50,9 @@ This step is only for testing purpose. If your env is correctly set, you don't n
50
50
51
51
- Set version number as x.y.z, and tag as **v**x.y.z (The version tag must start with **v**. You will find out why this is necessary in the next step.)
52
52
53
-
_You could do a GPG signature before preparing for the release. If you need to input the password to sign, and the maven doesn't provide you with the opportunity to do so, this may lead to failure of the release. To resolve this, you may run `gpg --sign xxx` in any file. This will allow it to remember the password for long enough to prepare for the release._
53
+
_You could do a GPG signature before preparing for the release. If you need to input the password to sign, and the maven doesn't provide you with the opportunity to do so, this may lead to failure of the release. To resolve this, you may run `gpg --sign xxx` in any file. This will allow it to remember the password for long enough to prepare for the release._
54
54
55
-
## Stage the release
55
+
## Stage the release
56
56
```
57
57
./mvnw release:perform -DskipTests -Pall
58
58
```
@@ -70,7 +70,7 @@ This script takes care of the following things:
70
70
1. Use `v` + `RELEASE_VERSION` as tag to clone the codes.
71
71
2. Complete `git submodule init/update`.
72
72
3. Exclude all unnecessary files in the target source tar, such as `.git`, `.github`, and `.gitmodules`. See the script for more details.
73
-
4. Execute `gpg` and `shasum 512` for source code tar.
73
+
4. Execute `gpg` and `shasum 512` for source code tar.
Create ExitSpan according to the operation name (e.g. service name, uri) and the new **ContextCarrier** and peer address
99
+
Create ExitSpan according to the operation name (e.g. service name, uri) and the new **ContextCarrier** and peer address
100
100
(e.g. ip+port, hostname+port).
101
101
102
102
### AbstractSpan
@@ -165,7 +165,7 @@ The value should be an integer. The response code of OAL entities corresponds to
165
165
#### Tag keys `db.statement` and `db.type`.
166
166
The value of `db.statement` should be a string that represents the database statement, such as SQL, or `[No statement]/`+span#operationName if the value is empty.
167
167
When the exit span contains this tag, OAP samples the slow statements based on `agent-analyzer/default/maxSlowSQLLength`.
168
-
The threshold of slow statement is defined in accordance with `agent-analyzer/default/slowDBAccessThreshold`.
168
+
The threshold of slow statement is defined in accordance with `agent-analyzer/default/slowDBAccessThreshold`.
169
169
Check **Slow Database Statement** document of OAP server for details.
170
170
171
171
#### Extension logic endpoint: Tag key `x-le`
@@ -184,7 +184,7 @@ The value of `x-le` should be in JSON format. There are two options:
For more examples, see [WitnessTest.java](../../../../../apm-sniffer/apm-agent-core/src/test/java/org/apache/skywalking/apm/agent/core/plugin/witness/WitnessTest.java)
332
332
333
-
333
+
334
334
335
335
### Implement an interceptor
336
-
As an interceptor for an instance method, it has to implement
336
+
As an interceptor for an instance method, it has to implement
1.`MeterFactory.counter` creates a new counter builder with the meter name.
519
519
1.`Counter.Builder.tag(String key, String value)` marks a tag key/value pair.
520
520
1.`Counter.Builder.mode(Counter.Mode mode)` changes the counter mode. `RATE` mode means the reporting rate to the backend.
@@ -547,6 +547,7 @@ histogram.addValue(3);
547
547
1.`Histogram.addValue(double value)` adds value into the histogram, and automatically analyzes what bucket count needs to be incremented. Rule: count into [step1, step2).
548
548
549
549
# Plugin Test Tool
550
+
550
551
The [Apache SkyWalking Agent Test Tool Suite](https://github.com/apache/skywalking-agent-test-tool) is an incredibly useful test tool suite that is available in a wide variety of agent languages. It includes the mock collector and validator. The mock collector is a SkyWalking receiver, like the OAP server.
551
552
552
553
You could learn how to use this tool to test the plugin in [this doc](Plugin-test.md). This is a must if you want to contribute plugins to the SkyWalking official repo.
@@ -560,6 +561,6 @@ Please follow these steps:
560
561
1. Follow this guide to develop. Make sure comments and test cases are provided.
561
562
1. Develop and test.
562
563
1. Provide the automatic test cases. Learn `how to write the plugin test case` from this [doc](Plugin-test.md)
563
-
1. Send a pull request and ask for review.
564
+
1. Send a pull request and ask for review.
564
565
1. The plugin committers will approve your plugins, plugin CI-with-IT, e2e, and the plugin tests will be passed.
0 commit comments