Commit Graph

354 Commits

Author SHA1 Message Date
Trask Stalnaker d42afabd91 Remove db.cassandra.keyspace and db.hbase.namespace, and clarify db.name (#1973)
Fixes #1760

## Changes

Removes `db.cassandra.keyspace` and `db.hbase.namespace` (in preference for using `db.name`).

Clarifies `db.name` in the case where a database product provides multiple concepts that could be mapped to `db.name`.
2021-10-08 11:58:31 +00:00
Dmitrii Anoshin d2279afe9e Add `k8s.container.restart_count` Resource attribute (#1945)
This change adds a Resource attribute to represent number of container restarts in kubernetes. This is can be used in k8s logs collection to identify a particular container instance, where the number of container restarts is a part of a log file path.

Co-authored-by: Tigran Najaryan <4194920+tigrannajaryan@users.noreply.github.com>
2021-10-06 12:10:27 +00:00
Bogdan Drutu cdf0cd8679 Update metrics semantic conventions to use the new instrument names (#1976)
Signed-off-by: Bogdan Drutu <bogdandrutu@gmail.com>

Co-authored-by: Carlos Alberto Cortez <calberto.cortez@gmail.com>
2021-10-05 15:51:33 +00:00
Bogdan Drutu db9fbcf0c7 Avoid using gRPC when generic RPC systems have same properties (#1914)
* Avoid using gRPC when generic RPC systems have same properties

The concept of "streaming" is supported by multiple protocols including gRPC, but also others.

Signed-off-by: Bogdan Drutu <bogdandrutu@gmail.com>

* Update specification/trace/semantic_conventions/rpc.md

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
2021-09-28 23:59:15 +00:00
Mateusz Rzeszutek 3758cba58b Capture HTTP request/response headers as span attributes (#1898)
* Capture HTTP request/response headers as span attributes

* Reference footnote [2]

* code review suggestions

* code review suggestions

* code review comments

* normalize HTTP header names

* Update specification/trace/semantic_conventions/http.md

Co-authored-by: Yuri Shkuro <yurishkuro@users.noreply.github.com>

* code review suggestion

* Add a CHANGELOG entry

* code review suggestions

Co-authored-by: Yuri Shkuro <yurishkuro@users.noreply.github.com>
2021-09-21 14:10:45 -04:00
Christian Neumüller 30fed0f050 Clarify some cases for http.host and http.client_ip. (#1890)
* Clarify some cases for http.host and http.client_ip.

* Fill in PR#.
2021-09-07 19:18:49 +00:00
Christian Neumüller 525baf1b76 Add event semantic conventions, update semantic convention generator to v0.5.0 (#1843)
Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
2021-09-03 16:59:33 +02:00
Ken Finnigan ca8c79d418 Add `consumer_id` to identify the consumer (#1810)
Resolves #1796
2021-08-23 20:27:08 +02:00
Joao Grassi 9b2611ca84 Adjust .NET casing (#1883) 2021-08-23 10:02:35 +02:00
Christian Neumüller 3fffd053af Consistently format enums, fix non-identifier IDs. (#1863) 2021-08-20 16:12:03 +02:00
(Eliseo) Nathaniel Ruiz Nowell 5bcb639d1d Lambda instrumentations should check if X-Ray parent context is valid (#1867) 2021-08-17 14:28:52 +02:00
Ken Finnigan f62dd99dc1 Update trace example for Kafka messaging (#1807) 2021-08-16 16:36:27 +02:00
Stavros Kontopoulos 845b29a06e Add FaaS metrics semantic conventions (#1736)
* Define FaaS Metric Semantics

Closes #1013

* adjust faas metrics

* fixes

* docs

* updates

* fixes

* update instruments

* use attributes

Co-authored-by: Michael Lavers <kolanos@gmail.com>
Co-authored-by: Carlos Alberto Cortez <calberto.cortez@gmail.com>
2021-08-10 14:09:34 -07:00
legendecas 227b4ff1b1 [semantic conventions] add alibaba cloud as a cloud provider (#1831)
Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
Co-authored-by: Carlos Alberto Cortez <calberto.cortez@gmail.com>
2021-08-03 11:22:31 +00:00
Bryce Buchanan cbc2e3953c Mobile spec additions (#1759)
* added spec changes per #1647

* added 'wired' as possible value to `net.host.connection_type`

* fixed spacing in CHANGELOG.md

* added mobile carrier attributes to  semantic_conventions/trace/general.yaml

* fixed issue revealed by

* reverted extra space per markdownlint

* made connection_type allow custom values

* added additional space

* removed manually added table & ran generator tool

* separated connection.type & connection.subtype

* updated changelog to reflect iteration

* added literal radio tech to connection.subtype table

* added  as option for connect.type

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
Co-authored-by: Carlos Alberto Cortez <calberto.cortez@gmail.com>
2021-07-12 09:32:33 -07:00
Christian Neumüller 25f029b2e2 Rework FaaS semantic conventions. (#1781) 2021-07-06 14:34:09 +02:00
Jakub Malinowski 450410f7f6 Rename Metrics labels to attributes (#1775) 2021-07-01 00:11:54 +02:00
Christian Neumüller ecec5145dc Remove examples from enums. (#1779) 2021-06-29 12:54:59 -07:00
Armin Ruech d56add2b1b Bump semconvgen to 0.4.1 (#1771) 2021-06-22 18:00:48 +02:00
Christian Neumüller 795e4ec00f Remove rpc.jsonrpc.method, clarify rpc.method instead. (#1748)
* Remove rpc.jsonrpc.method, clarify rpc.method instead.

* Add PR#.

* Clarify client side code.namespace/function.

* Use "ref" instead of "constraint: any_of".

This should be changed back once
https://github.com/open-telemetry/build-tools/issues/33
is resolved & the updated build tools available.

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
2021-06-14 16:59:09 -07:00
Rob Crowe c8201c16aa Add cockroachdb to db.system semantic conventions (#1725) 2021-05-28 16:26:21 +02:00
Nikita Salnikov-Tarnovski 56e0491893 Add `OTEL_SERVICE_NAME` environment variable (#1677)
* Add OTEL_SERVICE_NAME environment variable

Closes #709
2021-05-24 15:54:33 +02:00
James Sherlock 83a291c491 Add Device (Mobile) and OS Version Resource Semantic Attributes (#1596)
* Add Device (Mobile) and OS Version Resource Semantic Attributes

* Added OS Name (iOS) and OS Version (14.4) to `os`.
* Added Device Identifier and Model Identifier to a newly created `device` group.
2021-05-20 14:21:47 +02:00
Eric Mustin e9035a0368 Add memcached to db.system semantic conventions (#1689)
* Add memcached to db.system semantic conventions

As we already use `memcached` to represent the `db.system` Memcached in opentelemetry-python, I believe we should add to the specification recommendation e606542981/instrumentation/opentelemetry-instrumentation-pymemcache/src/opentelemetry/instrumentation/pymemcache/__init__.py (L160)
2021-05-17 16:51:06 +02:00
Yinchi Luo b2c25ee059 fix typo (#1691)
Should be instrumentation, not insrumentation
2021-05-12 20:55:30 +02:00
Armin Ruech 22886a4e1c Fix typo in openmetrics-guidelines.md (#1687)
Co-Authored-By: alberto <alberto.rdrz@gmail.com>

Co-authored-by: alberto <alberto.rdrz@gmail.com>
2021-05-10 10:16:25 -07:00
Rostislav Kirillov d10c8523b2 added JSON RPC specific attributes (#1643) 2021-05-07 18:13:43 +02:00
Reiley Yang 5bf423b6f8 Rename the metrics new_api.md to api.md and updated links (#1672) 2021-05-06 15:12:23 -07:00
Reiley Yang b2d24ae1a5 rename api.md to old_api.md and update links (#1674) 2021-05-06 14:53:04 -07:00
Robert Pająk 786bc86d2b Add possibility to disable `db.statement` (#1659) 2021-05-03 23:21:57 +02:00
Amir Blum f15465b5ba add rabbitmq to semantic conventions yaml (#1651)
* add rabbitmq to semantic conventions yaml

* add example for rabbitmq routing key

* messaging.rabbitmq - use required syntax

* messaging.rabbitmq generate markdown table from yaml

* update changelog with adding rabbitmq to yaml

Co-authored-by: Bogdan Drutu <bogdandrutu@gmail.com>
2021-04-27 08:36:28 -07:00
Anuraag Agrawal 6c1ab84bb2 Add details for filling resource for AWS Lambda. (#1610) 2021-04-15 19:00:34 +02:00
Jaana Dogan bc85b047c2 Have consistent formatting for semantic convention enums (#1598)
* Have consistent formatting for semantic convention enums

Currently, semantic convention enum values are not consistent.
For example, os.type values are all capitals whereas
cloud.infrastructure_service values are underscored lowercase.
This change improves the inconsistencies.

We also expect language implementations to autogenerate code
from enum values. Each language has their own conventions for
constant variable identifiers and we expect the consistent
formatting is going to help the language implementors.

Fixes #1519.
2021-04-15 17:43:00 +02:00
James Sherlock a1c1110c37 [semantic conventions] trivial: Amend Azure FaaS Description (#1595)
* Fix Azure Member Brief

Azure currently has an incorrect description associated with it. This fixes it 😄

* Update faas.md

Co-authored-by: Sergey Kanzhelev <S.Kanzhelev@live.com>
2021-04-05 15:21:59 -07:00
ivomagi 4aa113a9f1 Adding webengine definition under resources semantic conventions (#1293) 2021-04-01 16:29:36 +02:00
Anuraag Agrawal c94d2d1498 AWS SDK common and dynamodb conventions (#1422)
Co-authored-by: William Armiros <54150514+willarmiros@users.noreply.github.com>
Co-authored-by: Nikita Salnikov-Tarnovski <gnikem@gmail.com>
Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
2021-03-30 18:53:48 +02:00
Pablo Baeyens bc787fd36a Add aws.ecs.task.revision semantic convention (#1581) 2021-03-30 16:53:24 +02:00
Anuraag Agrawal 0f98135322 Add semantic conventions for instrumenting AWS Lambda. (#1442) 2021-03-24 22:28:16 +01:00
Jaana Dogan 435182a274 Avoid using "infrastructure" terminology for all cloud (#1530)
* Avoid using "infrastructure" terminology for all cloud

Infrastructure in cloud has a specific connotation for concepts
explained in Infrastructure-as-a-Service (IaaS). Avoid this
termilogy because it's exclusive of some other services/platforms
that is represented by the "cloud" namespace.

Renaming "infrastructure_service" to "service" also due to the new
key length limits we are considering and infrastructure_service is
a lengthy choice.
2021-03-22 23:56:07 +01:00
Armin Ruech f2db090205 Update to latest semconv table generator to fix int enum issue (#1564) 2021-03-22 13:51:59 +01:00
Armin Ruech 561ad88d7f Update semantic conventions to distinguish int from double (#1550) 2021-03-18 17:06:10 +01:00
Evan Anderson b984dae817 Add metric for currently-in-flight HTTP requests (#1378)
* Add metric for currently-in-flight HTTP requests

* Update name to active_requests

* Fix missing rename noticed by anuraaga

* Clarify `active_requests` are in-flight

Co-authored-by: Reiley Yang <reyang@microsoft.com>

* Switch to UpDownSumObserver

Co-authored-by: Reiley Yang <reyang@microsoft.com>
Co-authored-by: Joshua MacDonald <jmacd@users.noreply.github.com>
2021-03-16 09:19:35 -07:00
Jaana Dogan 580121698c Rename cloud.zone to cloud.availability_zone (#1495)
Co-authored-by: Christian Neumüller <christian+github@neumueller.me>
Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
2021-03-11 11:02:16 +01:00
Jaana Dogan c670bbd8fd Introduce EKS cluster semantic conventions (#1484) 2021-03-08 17:58:09 +01:00
Jaana Dogan e6cc959e46 Allow to collect host architecture (#1483) 2021-03-05 19:50:00 +01:00
Robert Pająk c3d71dffc8 http.url MUST NOT contain credentials (#1502) 2021-03-05 15:20:04 +01:00
Jaana Dogan 0e92f16571 Have consistent naming for Google Cloud services (#1496) 2021-03-04 17:48:22 +01:00
Jaana Dogan ece6eebf06 Clarify the cloud resource attributes (#1481) 2021-03-02 17:01:35 +01:00
Jaana Dogan 4d2346182b Add container runtime to container conventions (#1482) 2021-03-02 14:37:53 +01:00
Yaniv Davidi b5f94d5fe7 Add elasticsearch to db.system semantic conventions (#1463) 2021-02-25 23:47:00 +01:00
Tristan Sloughter 45859e70b2 erlang process.runtime attributes: remove TODO note and update descriptions (#1445)
* erlang process.runtime attributes: remove TODO note and update descriptions

* erlang: update spec matrix

* add erlang runtime example
2021-02-19 10:30:27 -08:00
Yuri Shkuro 55c4909ebb Fix capitalization of MUST NOT/SHOULD NOT (#1404)
* Fix capitalization of MUST NOT/SHOULD NOT

* remove redudndant clause
2021-02-05 15:30:06 -08:00
Jay Camp a336acd5b3 Add k8s.node semantic convention (#1390) 2021-02-04 18:48:34 +01:00
Ted Young eeff36dfd4 Add lifecycle statuses to all documents (#1385) 2021-02-04 15:06:46 +01:00
Jay Camp 78875d0fa7 Fix typo of service.id -> service.instance.id (#1383)
Co-authored-by: Bogdan Drutu <bogdandrutu@gmail.com>
2021-01-27 17:28:03 -05:00
William Armiros 28b6c5aa88 Lowercased ECS launch types (#1339)
* lowercased ECS launch types

* updated changelog

* updated tables with 2.1 tool

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
Co-authored-by: Bogdan Drutu <bogdandrutu@gmail.com>
2021-01-27 12:04:10 -08:00
Ben Hastings 4e3733c384 Update openmetrics-guidelines.md (#1376)
fixed typo in name and label keys section - replaced "t" for correct spelling "forbids"
2021-01-26 15:57:03 +01:00
Christian Neumüller b139dc2a34 Clarify/relax required resource attributes. (#1294) 2021-01-21 15:50:05 +01:00
Sergey Kanzhelev 4f13d9c80b regenerated tables after https://github.com/open-telemetry/build-tools/pull/24 (#1342) 2021-01-14 00:04:10 -08:00
Aaron Abbott d181135d6b update system metrics with changes from collector (#1308)
Co-authored-by: Tigran Najaryan <4194920+tigrannajaryan@users.noreply.github.com>
Co-authored-by: Bogdan Drutu <bogdandrutu@gmail.com>
2021-01-11 08:36:03 -08:00
Wolfgang Ziegler 2dc7db5ab3 Update faas.yaml (#1326)
Fix wording.
2021-01-07 12:34:51 -05:00
William Armiros 27569327dc added cloud.infrastructure_service attribute to resource spec (#1112)
Co-authored-by: Anuraag Agrawal <anuraaga@gmail.com>
Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
2021-01-07 13:16:04 +01:00
Anuraag Agrawal 9a9441f869 Fix typo in HSQLDB convention and add GEODE (#1321)
Co-authored-by: Sergey Kanzhelev <S.Kanzhelev@live.com>
2021-01-07 00:26:08 -08:00
Wolfgang Ziegler 6fd35a389e Introduce resource attribute `faas.max_memory` (#1296) 2021-01-04 23:42:01 +01:00
Carlos Alberto Cortez 4df1e98ddc Define the fallback case for service.name (#1269) 2020-12-14 16:59:35 +01:00
Frank Spitulski 84a9ddfe9a Add more attributes for Cassandra to database semantic conventions (#1217)
* feat(cassandra): more tags

* Update semantic_conventions/trace/database.yaml

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>

* Update semantic_conventions/trace/database.yaml

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>

* Update semantic_conventions/trace/database.yaml

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>

* incorporate changes

* Update semantic_conventions/trace/database.yaml

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>

* incorporate feedback

* additional feedback

* revert unchanged file

* Update semantic_conventions/trace/database.yaml

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>

* Update specification/trace/semantic_conventions/database.md

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>

* split cassandra to separate table

* Update specification/trace/semantic_conventions/database.md

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
Co-authored-by: Sergey Kanzhelev <S.Kanzhelev@live.com>
2020-12-09 14:23:23 -08:00
Bogdan Drutu 837f4898c0 Remove support to allow_different_nesting, from markdownlint (#1248)
* Remove support to allow_different_nesting, from markdownlint

Signed-off-by: Bogdan Drutu <bogdandrutu@gmail.com>

* Update specification/metrics/semantic_conventions/README.md

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>

* Run markdown-toc

Signed-off-by: Bogdan Drutu <bogdandrutu@gmail.com>

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
2020-11-30 06:33:56 -08:00
Josh Suereth 9e9364b0da Provide semantic conventions for RPC metrics (#1162)
Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
2020-11-26 18:06:38 +01:00
Mateusz Rzeszutek 0c0bae3f6d Add missing thread.* attributes to semconv yaml file (#1262)
Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
2020-11-26 17:53:19 +01:00
William Armiros 3df4ec410c Add semantic conventions for cloud provider-specific resource attributes (#1099) 2020-11-25 03:17:42 +01:00
Mateusz Rzeszutek f6f976a7de Add a SQL span naming suggestion: <db.operation> <db.name>.<db.sql.table> (#1219)
Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
Co-authored-by: Yuri Shkuro <yurishkuro@users.noreply.github.com>
Co-authored-by: Christian Neumüller <christian+github@neumueller.me>
2020-11-24 14:31:26 +01:00
Giovanni Liva 85daff3954 Yaml files for process semantic convention (#1227)
Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
2020-11-24 14:18:10 +01:00
Christian Neumüller 4a6610e5fb Add java.vm.name to process.runtime.description & more examples. (#1242)
Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
2020-11-24 14:10:23 +01:00
Christian Neumüller ed47f3887a Improve process.runtime description (editorial) (#1232)
Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
2020-11-23 13:08:46 +01:00
Vladimir Šor f2bc1ad6bd Add YAML definition for code-related semantic attributes. (#1229)
* Introduce code-related semantic attributes.

* Generate table for `code` semantic attributes from the yaml spec.

* Update semantic_conventions/trace/general.yaml

Co-authored-by: Christian Neumüller <christian+github@neumueller.me>

* Update semantic_conventions/trace/general.yaml

Co-authored-by: Christian Neumüller <christian+github@neumueller.me>

* Generate table for `code` semantic attributes from the yaml spec.

* Revert line-endings-only change

* Better function name for code.function example.

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>

Co-authored-by: Christian Neumüller <christian+github@neumueller.me>
Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
2020-11-19 18:55:10 +01:00
Justin Foote 3f358caa6b Add OpenMetrics guidance (#1154)
* Add OpenMetrics interop guidelines

* Add Prometheus Receiver guidelines; reference collector design

* Add OpenMetrics guidelines to changelog

* Add work in progress note to OpenMetrics guidance

Co-authored-by: Sergey Kanzhelev <S.Kanzhelev@live.com>
2020-11-17 09:15:45 -08:00
Justin Foote 3d64f93fc6 Add metric name pluralization guidelines (#1109) 2020-11-10 20:24:03 +01:00
Justin Foote be808a12d2 Remove deprecated span status codes from http semantic conventions (#1216) 2020-11-10 08:10:45 -08:00
Justin Foote 2cd9fbb859 Database semantic conventions: Add db.table, allow SQL keyword as db.operation (#1141)
* Add db.table to database semantic conventions

* Fix spacing in db semantic conventions

* Move db.table to SQL-specific call level attributes

* Clarify instructions for setting db.operation to a SQL keyword

* Specify that db.sql.table MUST NOT be set when not applicable

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>

* Add db.table and db.operation to CHANGELOG

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
2020-11-09 19:47:40 +01:00
Christian Neumüller 0ce086911a Specify process.runtime for Python. (#1160) 2020-11-09 16:52:54 +01:00
Anuraag Agrawal 355a7f5740 Use MUST consistently instead of SHALL (#1208)
* Use MUST consistently instead of shall.

* Update specification/trace/semantic_conventions/messaging.md

Co-authored-by: Christian Neumüller <christian+github@neumueller.me>

Co-authored-by: Christian Neumüller <christian+github@neumueller.me>
2020-11-08 15:48:53 -05:00
Yusuke Tsutsumi ce1a267d21 Updating gRPC status semantic conventions (#1156)
* Updating gRPC status semantic conventions

Since the simplification of trace status codes,
they no longer align with gRPC.

Clarifying the expected status code field for gRPC, as
well as the mappings between gRPC and OpenTelemetry status.

* Adding changelog entry

* Addressing feedback

Clarifying that gRPC spans should include the status code number,
rather than leave it ambiguous.

Adding gRPC semantic conventions in the yaml files to reflect these
changes.

* adding trailing whitespace

* Apply suggestions from code review

Co-authored-by: Christian Neumüller <christian+github@neumueller.me>

* addressing feedback

Ran table-generation to ensure that semantic conventions are added.

Removed tags for rpc.grpc yaml for now (not explicitly used).

* Update specification/trace/semantic_conventions/rpc.md

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>

* Addressing feedback

re-generating TOC with markdown-toc

There was a conflict with sub-headings matching the same string. As such
qualified all headings.

* Switching gRPC status_code type to enum

gRPC's status_code code is better expressed as an enum.

Co-authored-by: Christian Neumüller <christian+github@neumueller.me>
Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
2020-11-06 15:06:46 -08:00
Christian Neumüller bf1d9c6471 Rework headings of process semantic convention, add TOC. (#1191) 2020-11-04 12:34:42 -08:00
Christian Neumüller aa14918823 Fix absolute links to spec (#1192)
* Remove absolute links where possible.

* Work around semantic conventions.

* Docfx.

* Fix YAML.

* More docfx.
2020-11-04 12:29:48 -08:00
Christian Neumüller 9ec26f31ed Overhaul process command-line resource conventions. (#1137)
Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
2020-11-03 11:50:38 +01:00
Yuri Shkuro f06e3a22e2 Replace CAN with MAY (#1150) 2020-10-28 12:51:19 -04:00
Carlos Alberto Cortez e5de3ac8c1 Revert "Rename SpanContext to SpanReference. (#1075)" (#1127) 2020-10-24 00:16:31 +02:00
Ken Finnigan 8b6a13ad16 Resolve semantic inconsistencies for non traditional messaging (#1027)
Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
Co-authored-by: Christian Neumüller <christian+github@neumueller.me>
2020-10-21 15:28:20 +02:00
Giovanni Liva 98d2cc53f8 Add yaml for FaaS trace attributes (#1054)
Co-authored-by: Christian Neumüller <christian.neumueller@dynatrace.com>
Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
2020-10-19 18:36:54 +02:00
Aaron Abbott 3146dc01dc System metrics semantic conventions (#937)
* System metrics semantic conventions

Conventions from [OTEP
119](https://github.com/open-telemetry/oteps/pull/119)

* change process count to UpDownSumObserver

* fix system.cpu.utilization, use better example

* first several comments

* add description columns, update units to UCUM

* markdown-toc

* clarify OS process level metrics

* clarify load average exapmle

* move general conventions + OTEP 108 into README.md

* renamed swap -> paging

* add addition fs labels

* fix links

* fix link

* Update specification/metrics/semantic_conventions/README.md

Co-authored-by: Tigran Najaryan <4194920+tigrannajaryan@users.noreply.github.com>

* Update specification/metrics/semantic_conventions/README.md

Co-authored-by: Tigran Najaryan <4194920+tigrannajaryan@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: Tigran Najaryan <4194920+tigrannajaryan@users.noreply.github.com>

* fix tigran comments

* add disk io_time and operation_time

* add descriptions/footnotes for dropped packets and net errors

* lint, more info for net dropped packets/errors

* "dropped_packets" -> "dropped"

* Apply suggestions from James' code review

Co-authored-by: James Bebbington <jbebbington@google.com>

* comments from James' code review

* clarify windows perf counter

* Update specification/metrics/semantic_conventions/README.md

Co-authored-by: Joshua MacDonald <jmacd@users.noreply.github.com>

* reflow text

Co-authored-by: Tigran Najaryan <4194920+tigrannajaryan@users.noreply.github.com>
Co-authored-by: James Bebbington <jbebbington@google.com>
Co-authored-by: Joshua MacDonald <jmacd@users.noreply.github.com>
2020-10-15 12:07:07 -07:00
Josh Suereth b48cb0cff0 Fix typo in cloud resource convention. (#1097)
* Fix type in cloud convention.

* Run auto-md tool, cool!
2020-10-15 09:53:56 -07:00
Carlos Alberto Cortez 06db49aae3 Rename SpanContext to SpanReference. (#1075)
* Rename SpanContext to SpanReference.

* More updates.

* Update CHANGELOG

* Update specification/metrics/api.md

Co-authored-by: Christian Neumüller <christian+github@neumueller.me>

* Update specification/metrics/api.md

Co-authored-by: Christian Neumüller <christian+github@neumueller.me>

* Update specification/metrics/api.md

Co-authored-by: Christian Neumüller <christian+github@neumueller.me>

* Update specification/metrics/api.md

Co-authored-by: Christian Neumüller <christian+github@neumueller.me>

* Update specification/overview.md

Co-authored-by: Christian Neumüller <christian+github@neumueller.me>

* Update specification/overview.md

Co-authored-by: Christian Neumüller <christian+github@neumueller.me>

* Update specification/metrics/api.md

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>

* Add entry to the compliance matrix.

* Update specification/overview.md

Co-authored-by: Christian Neumüller <christian+github@neumueller.me>

Co-authored-by: Christian Neumüller <christian+github@neumueller.me>
Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
2020-10-14 08:40:18 -07:00
Giovanni Liva d07e2e8431 Add yaml for FaaS and Host resource attributes (#1056)
* Add yaml for FaaS and Host resource attributes

* Address feedback

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
2020-10-12 17:02:45 +02:00
Giovanni Liva f474696cfd Add yaml for K8s and OS resource attributes (#1057) 2020-10-09 16:04:18 +02:00
Giovanni Liva 31ec13ca2d Add yaml for Cloud, Container, and Deployment resource attributes (#1055) 2020-10-09 16:02:07 +02:00
Bogdan Drutu 138b4e4d88 Change Status to be consistent with Link and Event (#1067)
* Change Status to be consistent with Link and Event

Signed-off-by: Bogdan Drutu <bogdandrutu@gmail.com>

* Add changelog entry

Signed-off-by: Bogdan Drutu <bogdandrutu@gmail.com>

* Fix link to status

Signed-off-by: Bogdan Drutu <bogdandrutu@gmail.com>

* Update specification/trace/api.md

Co-authored-by: Yuri Shkuro <yurishkuro@users.noreply.github.com>

* Update specification/trace/api.md

Co-authored-by: Yuri Shkuro <yurishkuro@users.noreply.github.com>

* Fix markdown errors

Signed-off-by: Bogdan Drutu <bogdandrutu@gmail.com>

* Update specification/trace/api.md

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>

Co-authored-by: Yuri Shkuro <yurishkuro@users.noreply.github.com>
Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
2020-10-07 11:21:31 -07:00
Giovanni Liva 9315f21f9d Add telemetry and service yaml (#1026) 2020-09-30 17:16:04 -07:00
Michael Lavers 596552eb0b Fix HTTP Metric Semantics Typos (#1039) 2020-09-30 17:19:50 +02:00
Giovanni Liva 9f09d2db7e Add yaml semantic conventions for Messaging (#926) 2020-09-29 14:34:02 +02:00
Jay Camp b971d97b32 Explicitly specify cloud.provider values for common cloud providers (#1018)
* Explicitly specify cloud.provider values for common cloud providers

Before some cloud provider values were given as an examples but it was still
left open to interpretation about what that meant. This makes it more explicit
that these are known values for those particular cloud providers.

* Apply suggestions from code review

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
2020-09-29 14:12:05 +02:00
Ted Young bbd284a9d9 Error Flagging with Status Codes (#966)
* StatusSource definition

* Update HTTP status code mapping

* Remove span status

* Apply feedback.

* Remove unused link.

* markdownlint

* spelling

Co-authored-by: Carlos Alberto Cortez <calberto.cortez@gmail.com>
2020-09-24 11:24:31 -07:00
Giovanni Liva 5874138953 Add yaml semantic conventions for RPC (#925) 2020-09-24 15:06:48 +02:00
Anuraag Agrawal cb368a7a64 Add process.runtime.name / version describing executing runtime (#882)
* Add process.runtime.name / version to capture information about executing runtime.

* .NET core probably considered reference implementation going forward.

* Changelog

* Cleanups

* Fix go compiler

* Compiler

* Update specification/resource/semantic_conventions/process.md

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>

* Java not constants

* Space

* Ecilpse:

* Add TODOs

* Avoid direct links

* Revert "Avoid direct links"

This reverts commit 7906c266570d993eaef28357d3cd25065be4d658.

* Try direct link

* Update Ruby

* Update specification/resource/semantic_conventions/process.md

Co-authored-by: Tristan Sloughter <t@crashfast.com>

* Consistency

* lint

* Android

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
Co-authored-by: Bogdan Drutu <bogdandrutu@gmail.com>
Co-authored-by: Tristan Sloughter <t@crashfast.com>
2020-09-22 11:25:07 -07:00
Armin Ruech f6cd4c2e1a Remove obsolete `http.status_text` from semantic conventions (#972) 2020-09-22 11:49:09 +02:00
Christian Neumüller 0ce8f09464 Exception semantic conventions: Add example & more explanation for exception.escaped. (#946)
* Add example & explanation for exception.escaped.

* Reshuffle paragraphs.

* Remove potentially controversial changes.

* Fill in CHANGELOG link.

* Address review comments.

* Wording

Co-authored-by: Tigran Najaryan <4194920+tigrannajaryan@users.noreply.github.com>

* Use actual OTel-Java API.

* Revert "Use actual OTel-Java API."

This reverts commit d359f477017d4ec0f71191eabae6b1edecee79fb.

* Clarify CHANGELOG

* Re-generate tables.

* Typo in CHANGELOG.md

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>

* Clarify exception escaped description.

Co-authored-by: Tigran Najaryan <4194920+tigrannajaryan@users.noreply.github.com>
Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
2020-09-19 08:24:46 -04:00
Tigran Najaryan 22acfb9aa6 Fix reference to service.instance.id (#957)
Was previously incorrectly referenced as service.id.
2020-09-16 16:01:56 +02:00
Armin Ruech 044aef6378 Add semantic convention for source code attributes (#901) 2020-09-15 17:33:58 +02:00
Giovanni Liva 5f0ed87925 Add yaml semantic conventions for Exception (#927) 2020-09-15 15:30:38 +02:00
Giovanni Liva a50ad7376b Add yaml semantic conventions for Database (#928)
* Add yaml semantic conventions for Database

* Address feedback
2020-09-11 09:15:46 -07:00
Carlos Alberto Cortez 91e93292b8 Use Deployment Environment in Resources' README instead of Environment. (#851) 2020-09-08 20:09:48 +02:00
Christian Neumüller 0da3c1a599 Add exception.escaped attribute. (#784)
* Add exception.escaped attribute.

This reverts commit 80ea27df4dd858b686d91ef37dad89aa8cd89439.

* New wording for API change.

* Remove additional condition for escaped parameter.

* Remove exception.escaped from the API.

* Add CHANGELOG entry.

* Wrong PR# in CHANGELOG.

* Wrong wrong PR# in CHANGELOG (hey anagrams!).

* Closing )

* Typos

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
2020-09-08 07:44:34 -07:00
Gene Liverman 7f54e65cf7 Fix the rendering of the table (#921)
* Fix table display

* Update specification/trace/semantic_conventions/span-general.md

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>

Co-authored-by: Sergey Kanzhelev <S.Kanzhelev@live.com>
Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
2020-09-04 11:21:30 -07:00
Tigran Najaryan 6d12dec4d9 Delete sentence about using span name when faas.name is absent (#915)
As pointed out here https://github.com/open-telemetry/opentelemetry-specification/pull/888#discussion_r478866767
if faas.name is not set, the Instrumentation probably doesn't know the name
and thus the span name would most likely also not contain it.

Co-authored-by: Sergey Kanzhelev <S.Kanzhelev@live.com>
2020-09-03 13:13:50 -07:00
Armin Ruech 3c241627c3 Fix Ruby link reference in exceptions.md (#917) 2020-09-02 20:37:52 +02:00
Armin Ruech f6f5ce62ef Add semantic conventions for outgoing FaaS invocations (#862) 2020-09-02 17:18:46 +02:00
gfuller1 c2a9e386a4 Add semantic conventions for HTTP metrics (#739)
* add http metric label spec

* typo

* update attribute locations and clarify which to inlcude, alter and exclude

* add metric instruments list

* simplify intro sections, add requirement columns, clarify labels, fix normative directives and more

* fix HTTP strings

* add count metric instrument and shorten duration metric name

* remove dependency on http.md, add more notes and examples and general cleanup

* replace span.kind with type

* add missing labels and cleanup links

* substitution->alternatives and remove section not needed

* make request count metric instrument plural

* formatting

* clarify type column

* update intro and fix units

* breakout metric instrument table

* remove http.route since it is the same as http.target after http.target is simplified

* update net labels to link to definition

* add lowercase requirement to http.scheme

* formatting

Co-authored-by: gfuller <gfuller@newrelic.com>
Co-authored-by: Bogdan Drutu <bogdandrutu@gmail.com>
2020-08-30 08:43:14 -07:00
Tigran Najaryan a5f6991ebe Clarify function name conventions (#888) 2020-08-28 01:28:30 +02:00
Giovanni Liva 521dfd99aa YAML Model for Semantic Conventions (#571)
* First model draft

* Fix checkstyle

* Generate network table from YAML

* HTTP semantic convention tables

* Fix requirements order

* Add code and basic documentation

* Missing \n

* Remove tool

* Add General and HTTP semantic convention

* Update table style

* yaml->semantic_conventions

* Fix small errors

* Fix docfx errors

* Update Makefile to use otel Docker repo

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
2020-08-27 13:18:51 -07:00
Bogdan Drutu be35f68e5a Rename CorrelationContext to Baggage (#857)
* Rename CorrelationContext to Baggage

Signed-off-by: Bogdan Drutu <bogdandrutu@gmail.com>

* Update CHANGELOG.md

Co-authored-by: Sergey Kanzhelev <S.Kanzhelev@live.com>
2020-08-25 23:15:07 -07:00
Anuraag Agrawal 9b449af77e Remove version convention / semver prefix from versions. (#873)
* Remove version convention / semver prefix from versions.

* Moar

* api.md

* Examples of version strings.

* Apply suggestions from code review

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>

* spaec

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
Co-authored-by: Carlos Alberto Cortez <calberto.cortez@gmail.com>
Co-authored-by: Bogdan Drutu <bogdandrutu@gmail.com>
2020-08-25 18:49:52 -07:00
Emmanuel Courreges a69a84b879 Add "Deployment / environment" subsection in "Environment" (#606)
Merge "Deployment Service / Kubernetes" section into "Environment" section for consistency
Create deployment_environment.md for new deployment.environment attribute

Signed-off-by: CI-Bot for Emmanuel Courreges <emmanuel.courreges@orange.com>
2020-08-21 16:01:15 +02:00
Bogdan Drutu ad8e02ae9a Remove duplicate hostname attribute (#838) 2020-08-20 21:11:40 +02:00
Bogdan Drutu 11997ecad6 Fix lint check in makefile, fix errors (#837)
Signed-off-by: Bogdan Drutu <bogdandrutu@gmail.com>
2020-08-19 14:43:05 -07:00
Mateusz Rzeszutek 6e96f1bbee Add semantic conventions for thread.name and thread.id span attributes (#789) 2020-08-18 17:55:42 +02:00
Nikita Salnikov-Tarnovski 36eb583e87 Add semantic convention for telemetry.auto.version (#799) 2020-08-17 09:41:58 -07:00
Anuraag Agrawal 3bb80b2ad1 Add link to exceptions from folder README (#795) 2020-08-13 07:33:39 -07:00
Christian Neumüller 1d03f8f5ec Fix exception.stacktrace recommendation for Ruby. (#765)
* Fix exception.stacktrace recommendation for Ruby.

All other stacktraces use the full message (including type, message,
etc), for Ruby only the plain stacktrace.

* Don't downgrade Ruby version.
2020-08-12 18:40:26 -07:00
Akash Suresh a6f219b6bb k8s: Differentiate container spec name and container name (#762) 2020-08-07 17:57:46 +02:00
Reiley Yang 3c720edee4 DocFX sanity check (#742) 2020-07-27 19:51:44 +02:00
Bogdan Drutu 7bc2b83d58 Add semantic conventions for all Kubernetes objects (#732)
Signed-off-by: Bogdan Drutu <bogdandrutu@gmail.com>
2020-07-25 13:49:59 -07:00
Bogdan Drutu 41869b89aa Split resource semantic conventions in smaller files (#727)
Signed-off-by: Bogdan Drutu <bogdandrutu@gmail.com>
2020-07-23 09:49:11 -04:00
Matthew Wear 18c42b60ca Exception reporting specification (#697)
* Add semantic conventions for errors

* Update error.type description

Co-Authored-By: Armin Ruech <armin.ruech@gmail.com>

* update semantic conventions for exceptions

* add details for attributes; remove log.severity; add API details

* rename exceptions.md -> exception-reporting.md

* more accurately describe format for java

* alphabetize languages in stacktrace representation table

* prefer dynamic type over static type

* add log.severity convention

* Revert "add log.severity convention"

This reverts commit 137556e44bf74e6d76a17bd81943702a460cb9de.

* rename stacktrace -> exception.stacktrace

* move file to semantic conventions directory

* move RecordException to API

* fix formatting

Co-authored-by: Armin Ruech <armin.ruech@gmail.com>
2020-07-17 12:52:48 -04:00
Armin Ruech c724898be9 Adapt semantic conventions for the span name of messaging systems (#690)
* Adapt messaging semantic conventions to include the operation in the span name

* Specify that the operation name must match the respective attribute if the suggested span name format is used

* Update span names in examples

* Consolidate definition of operation names into a separate section

* Consolidate capitalization

* Reference Conversation ID definition

* Consolidate MD syntax

* Organize definitions

* Organize definitions

* Reference definitions

* Allow artificial destinations as span name if neither destination name nor conversation ID are suitable

* Do not use conversation IDs for span name

* Wording

Co-authored-by: Christian Neumüller <christian.neumueller@dynatrace.com>

* Fix typo

* Add more links and guidance on messaging.operation

* Fix changelog

Co-authored-by: Christian Neumüller <christian.neumueller@dynatrace.com>
2020-07-15 13:14:56 -07:00
Armin Ruech f89b9c568c Add resource semantic conventions for operating systems (#693) 2020-07-15 16:22:13 +02:00
Anuraag Agrawal 72cb7df3e3 Add mapping for nginx 499 http status (#677) 2020-07-10 17:56:07 +02:00
Tyler Yahn 99707b5a5c Update resource `process.*` descriptions (#695)
Not all Unix based OSs have `procfs` (Darwin) or have it enabled by
default (FreeBSD). Update the description to be specific to Linux
systems.
2020-07-09 23:15:10 -07:00
Armin Ruech ad04016439 Fix Redis sample (db.redis.database_index was missing) (#692) 2020-07-09 19:26:56 +02:00
Armin Ruech c45e0c33a7 Revise and extend semantic conventions for databases (#575) 2020-07-01 19:29:01 +02:00
Anuraag Agrawal 2c07f78112 Add peer.service semantic convention to indicate the name of a target… (#652)
* Add peer.service semantic convention to indicate the name of a target remote service.

* Apply suggestions from code review

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>

* Simplify

* Remove fallback wording

* Needs to be configured using instrumentation

* CHANGELOG

* Clarify relationship with rpc.service and peer.service and some examples

* Clarify example

* Move peer.service / rpc.service relationship explanation to rpc doc.

* Apply suggestions from code review

Co-authored-by: Christian Neumüller <christian+github@neumueller.me>

* Update specification/trace/semantic_conventions/span-general.md

Co-authored-by: Christian Neumüller <christian+github@neumueller.me>

* Cleanup

* Tweak

* Update specification/trace/semantic_conventions/rpc.md

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>

* Update CHANGELOG.md

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>

* Apply suggestions from code review

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>

* Update specification/trace/semantic_conventions/span-general.md

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>

* TOC

* Apply suggestions from code review

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
Co-authored-by: Christian Neumüller <christian+github@neumueller.me>
2020-06-30 09:32:23 -07:00
Lei Wang 2296634e18 Add semantic conventions for container id (#673)
* Add semantic conventions for container id

* Update specification/resource/semantic_conventions/README.md

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>

* Update specification/resource/semantic_conventions/README.md

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>

Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
2020-06-30 08:25:40 -07:00
James Bebbington cdbda6cddb Added semantic conventions for the "process" resource (#635) 2020-06-29 18:00:03 -07:00
Anuraag Agrawal 9a1b74f9c1 Add semantic conventions for http content size (#641)
* Add semantic conventions for http content size

* Suffix not midfix
2020-06-25 18:02:02 -04:00
Armin Ruech ed21f09e46 Extend semantic conventions for RPC and allow non-gRPC calls (#604)
* Generalize RPC semantic conventions to allow non-gRPC spans

* Add method name to attributes

* Require specifying `net.transport` for non-IP connections

* Do not require providing the port when it's not available

* Add package name to rpc.service and make it optional when not applicable or unknown

* Add note and example distinguishing the service.name resource attribute from rpc.service

* Distinguish RPC spans from HTTP spans

* Improve wording

Co-authored-by: Christian Neumüller <christian+github@neumueller.me>

* Improve wording

* Improve wording even more

Co-authored-by: Christian Neumüller <christian+github@neumueller.me>

* Clarify span name format

* Update changelog

* rpc.method: required -> recommended

* rpc.service: required -> recommended

Co-authored-by: Christian Neumüller <christian+github@neumueller.me>
2020-06-17 10:58:26 -07:00
Armin Ruech 4ba638ad0d Add span attribute to indicate cold starts of Function as a Service executions (#650)
* Add `faas.coldstart` attribute

* Update changelog
2020-06-15 11:15:02 -07:00
Armin Ruech 79707b7df9 Link from trace (and metric) semantic conventions to resources (#603) 2020-05-14 10:11:11 -07:00
Armin Ruech 709940084a Fix HTTP span example (#576)
`host.port` was renamed to `net.host.port` in #349
2020-04-28 15:29:29 +02:00
Christian Neumüller b03e37895b Clarify messaging.system. (#558)
I'm not sure what this should have to do with vendors, according to the examples, this would be the actual system names themselves. Otherwise the vendor for kafka would probably be "Apache", for example.
2020-04-22 07:35:51 -07:00
Armin Ruech 587693abbf Add payload size to messaging semantic conventions (#550) 2020-04-17 18:07:41 +02:00
Armin Ruech b477c8dbba Clarify span status guidance for HTTP spans (#537) 2020-04-14 16:54:50 +02:00
Giovanni Liva 8119013630 Add missing link (#561) 2020-04-10 07:35:33 -07:00
Armin Ruech 4d1da099a0 Fix markdown-link-check and dead links (#555) 2020-04-09 16:36:01 +02:00
Giovanni Liva e85fca0fc1 Add Semantic Conventions for Function as a Service (#471) 2020-04-07 17:12:45 +02:00
Armin Ruech 929e370037 Define span attributes for messaging systems (#418) 2020-04-07 17:08:56 +02:00
Bogdan Drutu 0dceae42ab Move specifications into sub-directories per signal (#546)
Signed-off-by: Bogdan Drutu <bogdandrutu@gmail.com>
2020-04-06 17:25:53 -04:00