Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 19 additions & 0 deletions .chloggen/add-dotnet-remoting-conventions.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# Use this changelog template to create an entry for release notes.

# One of 'breaking', 'deprecation', 'new_component', 'enhancement', 'bug_fix'
change_type: new_component

# The name of the area of concern in the attributes-registry, (e.g. http, cloud, db)
component: rpc

# A brief description of the change. Surround your text with quotes ("") if it needs to start with a backtick (`).
note: Add .NET Remoting semantic conventions for RPC spans and metrics.

# Mandatory: One or more tracking issues related to the change. You can use the PR number here if no issue exists.
# The values here must be integers.
issues: [3422]

# (Optional) One or more lines of additional information to render under the primary note.
# These lines will be padded with 2 spaces and then inserted directly into the document.
# Use pipe (|) for multiline entries.
subtext:
1 change: 1 addition & 0 deletions docs/registry/attributes/rpc.md
Original file line number Diff line number Diff line change
Expand Up @@ -72,6 +72,7 @@ Semantic conventions for individual RPC frameworks SHOULD document what `rpc.res
| `dubbo` | [Apache Dubbo](https://dubbo.apache.org/) | ![Development](https://img.shields.io/badge/-development-blue) |
| `grpc` | [gRPC](https://grpc.io/) | ![Development](https://img.shields.io/badge/-development-blue) |
| `jsonrpc` | [JSON-RPC](https://www.jsonrpc.org/) | ![Development](https://img.shields.io/badge/-development-blue) |
| `netframework_remoting` | [.NET Remoting](https://docs.microsoft.com/previous-versions/dotnet/netframework-3.0/72x4h507(v=vs.85)) | ![Development](https://img.shields.io/badge/-development-blue) |

## Deprecated RPC Attributes

Expand Down
1 change: 1 addition & 0 deletions docs/rpc/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,7 @@ Semantic conventions for RPC are defined for the following signals:

Technology specific semantic conventions are defined for the following RPC systems:

* [.NET Remoting](dotnet-remoting.md): Semantic Conventions for *.NET Remoting*.
* [Connect](connect-rpc.md): Semantic Conventions for *Connect RPC*.
* [Dubbo](dubbo.md): Semantic Conventions for *Apache Dubbo*.
* [gRPC](grpc.md): Semantic Conventions for *gRPC*.
Expand Down
259 changes: 259 additions & 0 deletions docs/rpc/dotnet-remoting.md

Large diffs are not rendered by default.

2 changes: 2 additions & 0 deletions docs/rpc/rpc-metrics.md
Original file line number Diff line number Diff line change
Expand Up @@ -142,6 +142,7 @@ Semantic conventions for individual RPC frameworks SHOULD document what `rpc.res
| `dubbo` | [Apache Dubbo](https://dubbo.apache.org/) | ![Development](https://img.shields.io/badge/-development-blue) |
| `grpc` | [gRPC](https://grpc.io/) | ![Development](https://img.shields.io/badge/-development-blue) |
| `jsonrpc` | [JSON-RPC](https://www.jsonrpc.org/) | ![Development](https://img.shields.io/badge/-development-blue) |
| `netframework_remoting` | [.NET Remoting](https://docs.microsoft.com/previous-versions/dotnet/netframework-3.0/72x4h507(v=vs.85)) | ![Development](https://img.shields.io/badge/-development-blue) |

<!-- prettier-ignore-end -->
<!-- END AUTOGENERATED TEXT -->
Expand Down Expand Up @@ -247,6 +248,7 @@ Semantic conventions for individual RPC frameworks SHOULD document what `rpc.res
| `dubbo` | [Apache Dubbo](https://dubbo.apache.org/) | ![Development](https://img.shields.io/badge/-development-blue) |
| `grpc` | [gRPC](https://grpc.io/) | ![Development](https://img.shields.io/badge/-development-blue) |
| `jsonrpc` | [JSON-RPC](https://www.jsonrpc.org/) | ![Development](https://img.shields.io/badge/-development-blue) |
| `netframework_remoting` | [.NET Remoting](https://docs.microsoft.com/previous-versions/dotnet/netframework-3.0/72x4h507(v=vs.85)) | ![Development](https://img.shields.io/badge/-development-blue) |

<!-- prettier-ignore-end -->
<!-- END AUTOGENERATED TEXT -->
Expand Down
2 changes: 2 additions & 0 deletions docs/rpc/rpc-spans.md
Original file line number Diff line number Diff line change
Expand Up @@ -174,6 +174,7 @@ and SHOULD be provided **at span creation time** (if provided at all):
| `dubbo` | [Apache Dubbo](https://dubbo.apache.org/) | ![Development](https://img.shields.io/badge/-development-blue) |
| `grpc` | [gRPC](https://grpc.io/) | ![Development](https://img.shields.io/badge/-development-blue) |
| `jsonrpc` | [JSON-RPC](https://www.jsonrpc.org/) | ![Development](https://img.shields.io/badge/-development-blue) |
| `netframework_remoting` | [.NET Remoting](https://docs.microsoft.com/previous-versions/dotnet/netframework-3.0/72x4h507(v=vs.85)) | ![Development](https://img.shields.io/badge/-development-blue) |

<!-- prettier-ignore-end -->
<!-- END AUTOGENERATED TEXT -->
Expand Down Expand Up @@ -301,6 +302,7 @@ and SHOULD be provided **at span creation time** (if provided at all):
| `dubbo` | [Apache Dubbo](https://dubbo.apache.org/) | ![Development](https://img.shields.io/badge/-development-blue) |
| `grpc` | [gRPC](https://grpc.io/) | ![Development](https://img.shields.io/badge/-development-blue) |
| `jsonrpc` | [JSON-RPC](https://www.jsonrpc.org/) | ![Development](https://img.shields.io/badge/-development-blue) |
| `netframework_remoting` | [.NET Remoting](https://docs.microsoft.com/previous-versions/dotnet/netframework-3.0/72x4h507(v=vs.85)) | ![Development](https://img.shields.io/badge/-development-blue) |

<!-- prettier-ignore-end -->
<!-- END AUTOGENERATED TEXT -->
Expand Down
4 changes: 4 additions & 0 deletions model/rpc/registry.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -107,4 +107,8 @@ groups:
value: 'jsonrpc'
brief: '[JSON-RPC](https://www.jsonrpc.org/)'
stability: development
- id: netframework_remoting
value: 'netframework_remoting'
brief: '[.NET Remoting](https://docs.microsoft.com/previous-versions/dotnet/netframework-3.0/72x4h507(v=vs.85))'
stability: development
stability: development
54 changes: 54 additions & 0 deletions model/rpc/spans.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -425,3 +425,57 @@ groups:
requirement_level: opt_in
- ref: rpc.response.metadata
requirement_level: opt_in

- id: span.rpc.netframework_remoting.call.client
type: span
stability: development
brief: This span represents an outgoing Remote Procedure Call (RPC).
note: |
`rpc.system.name` MUST be set to `"netframework_remoting"` and SHOULD be provided **at span creation time.**

**Span name:** refer to the [Span Name](/docs/rpc/rpc-spans.md#name) section.

**Span kind** MUST be `CLIENT`.

**Span status**: refer to the [Recording Errors](/docs/general/recording-errors.md)
document for details on how to record span status.
extends: rpc
span_kind: client
attributes:
- ref: rpc.response.status_code
requirement_level:
conditionally_required: if available.
brief: The fully-qualified .NET exception type that was thrown by the .NET Remoting call, used as the status code.
note: |
All non-empty status codes SHOULD be considered errors.
- ref: rpc.request.metadata
requirement_level: opt_in
- ref: rpc.response.metadata
requirement_level: opt_in

- id: span.rpc.netframework_remoting.call.server
type: span
stability: development
extends: rpc.server
span_kind: server
brief: This span represents an incoming Remote Procedure Call (RPC).
note: |
`rpc.system.name` MUST be set to `"netframework_remoting"` and SHOULD be provided **at span creation time.**

**Span name:** refer to the [Span Name](/docs/rpc/rpc-spans.md#name) section.

**Span kind** MUST be `SERVER`.

**Span status**: refer to the [Recording Errors](/docs/general/recording-errors.md)
document for details on how to record span status.
attributes:
- ref: rpc.response.status_code
requirement_level:
conditionally_required: if available.
brief: The fully-qualified .NET exception type that was thrown by the .NET Remoting call, used as the status code.
note: |
All non-empty status codes SHOULD be considered errors.
- ref: rpc.request.metadata
requirement_level: opt_in
- ref: rpc.response.metadata
requirement_level: opt_in
Loading