Skip to content

Commit

Permalink
add clarification
Browse files Browse the repository at this point in the history
  • Loading branch information
lmolkova committed Oct 22, 2024
1 parent 75116ec commit 3e05a9e
Show file tree
Hide file tree
Showing 2 changed files with 10 additions and 2 deletions.
6 changes: 5 additions & 1 deletion docs/database/database-spans.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,11 @@ linkTitle: Client Calls
> for at least six months after it starts emitting both sets of conventions.
> * SHOULD drop the environment variable in the next major version.
**Span kind:** SHOULD be `CLIENT`.
**Span kind:** SHOULD be `CLIENT`. It MAY be set to `INTERNAL` on spans representing
in-memory database calls.
It's RECOMMENDED to use `CLIENT` kind when database system being instrumented usually
runs in a different process than its client or when database calls happen over
instrumented protocol such as HTTP.

Span that describes database call SHOULD cover the duration of the corresponding call as if it was observed by the caller (such as client application).
For example, if a transient issue happened and was retried within this database call, the corresponding span should cover the duration of the logical operation
Expand Down
6 changes: 5 additions & 1 deletion docs/gen-ai/gen-ai-spans.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,11 @@ linkTitle: Generative AI traces

A request to an Generative AI is modeled as a span in a trace.

**Span kind:** SHOULD always be `CLIENT`.
**Span kind:** SHOULD be `CLIENT`. It MAY be set to `INTERNAL` on spans representing
call to models running in the same process.
It's RECOMMENDED to use `CLIENT` kind when GenAI system being instrumented usually
runs in a different process than its client or when GenAI call happens over
instrumented protocol such as HTTP.

## Name

Expand Down

0 comments on commit 3e05a9e

Please sign in to comment.