Skip to content

Commit 457faf5

Browse files
authored
Merge pull request #7 from Dharin-shah/main
update Readme
2 parents d0ad8a2 + d1615f9 commit 457faf5

File tree

2 files changed

+65
-1
lines changed

2 files changed

+65
-1
lines changed

README.md

Lines changed: 37 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,38 @@
1-
# appium-plugins
1+
# Appium Plugins
2+
23
Home for Appium Plugins maintained by the BrowserStack Open Source Program Office
4+
5+
To install checkout individual README for each plugins in the repo
6+
7+
8+
To activate an installed plugin so that it has an effect for the running server, make sure to include it in the list of activated plugins when starting the server:
9+
10+
```
11+
appium --plugins=opentelmetry
12+
```
13+
14+
For information and documentation about each plugin hosted in this repo, head to the individual READMEs:
15+
16+
* [Opentelemetry plugin](packages/opentelemetry) - A plugin designed to automatically generate traces for http events in appium server
17+
18+
# Developer
19+
20+
To run:
21+
22+
```
23+
npm run clean
24+
```
25+
26+
or
27+
28+
```
29+
npm run bootstrap
30+
npm install
31+
npm run build
32+
```
33+
34+
To Test:
35+
36+
```
37+
npm test:unit
38+
```

packages/opentelemetry/README.md

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
# Appium Opentelemetry Plugin
2+
3+
With Appium 2.0, we can now use opentelemetry as observability tool without bundling it with appium main server
4+
5+
This plugin will help generate http traces automatically once used and also allow dynamic configurations for different exporters such as prometheus, jaeger, zipkin or just basic console logs.
6+
7+
## Installation - Server
8+
9+
Install the plugin using Appium's plugin CLI, either as a named plugin or via NPM (TODO):
10+
11+
```
12+
appium plugin install opentelemetry
13+
appium plugin install --source=npm @browserstack/opentelemetry-plugin
14+
```
15+
16+
Install the plugin using Appium's plugin CLI, locally:
17+
18+
```
19+
appium plugin install <path-to-repo>/packages/opentelemetry --source local
20+
```
21+
22+
## Activation
23+
24+
The plugin will not be active unless turned on when invoking the Appium server:
25+
26+
```
27+
appium --plugins=opentelemetry
28+
```

0 commit comments

Comments
 (0)