-
Notifications
You must be signed in to change notification settings - Fork 897
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge branch 'main' into reyang/async-counter
- Loading branch information
Showing
5 changed files
with
73 additions
and
28 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,22 @@ | ||
| groups: | ||
| - id: webengine_resource | ||
| prefix: webengine | ||
| brief: > | ||
| Resource describing the packaged software running the application code. Web engines are typically executed using process.runtime. | ||
| attributes: | ||
| - id: name | ||
| type: string | ||
| required: always | ||
| brief: > | ||
| The name of the web engine. | ||
| examples: ['WildFly'] | ||
| - id: version | ||
| type: string | ||
| brief: > | ||
| The version of the web engine. | ||
| examples: ['21.0.0'] | ||
| - id: description | ||
| type: string | ||
| brief: > | ||
| Additional description of the web engine (e.g. detailed version and edition information). | ||
| examples: ['WildFly Full 21.0.0.Final (WildFly Core 13.0.1.Final) - 2.2.2.Final'] |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,22 @@ | ||
| # Webengine | ||
|
|
||
| **type:** `webengine` | ||
|
|
||
| **Description:** Resource describing the packaged software running the application code. Web engines are typically executed using process.runtime. | ||
|
|
||
| <!-- semconv webengine_resource --> | ||
| | Attribute | Type | Description | Examples | Required | | ||
| |---|---|---|---|---| | ||
| | `webengine.name` | string | The name of the web engine. | `WildFly` | Yes | | ||
| | `webengine.version` | string | The version of the web engine. | `21.0.0` | No | | ||
| | `webengine.description` | string | Additional description of the web engine (e.g. detailed version and edition information). | `WildFly Full 21.0.0.Final (WildFly Core 13.0.1.Final) - 2.2.2.Final` | No | | ||
| <!-- endsemconv --> | ||
|
|
||
| Information describing the web engine SHOULD be captured using the values acquired from the API provided by the web engine, preferably during runtime, to avoid maintenance burden on engine version upgrades. As an example - Java engines are often but not always packaged as application servers. For Java application servers supporting Servlet API the required information MAY be captured by invoking `ServletContext.getServerInfo()` during runtime and parsing the result. | ||
|
|
||
| A resource can be attributed to at most one web engine. | ||
|
|
||
| The situations where there are multiple candidates, it is up to instrumentation library authors to choose the web engine. To illustrate, let's look at a Python application using Apache HTTP Server with mod_wsgi as the server and Django as the web framework. In this situation: | ||
|
|
||
| * Either Apache HTTP Server or `mod_wsgi` MAY be chosen as `webengine`, depending on the decision made by the instrumentation authors. | ||
| * Django SHOULD NOT be set as an `webengine` as the required information is already available in insrumentation library and setting this into `webengine` would duplicate the information. |
Oops, something went wrong.