Add semantic conventions for log_source attributes

open-telemetry · Oct 14, 2021 · 6bc026a · 6bc026a
1 parent ecc2635
commit 6bc026a
Show file tree

Hide file tree

Showing 3 changed files with 35 additions and 0 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -19,6 +19,8 @@ release.
   ([#1935](https://github.com/open-telemetry/opentelemetry-specification/pull/1935))
 
 ### Logs
+- Add log_source attributes.
+  ([#2022](https://github.com/open-telemetry/opentelemetry-specification/pull/2022))
 
 ### Resource
 

diff --git a/spec-compliance-matrix.md b/spec-compliance-matrix.md
@@ -94,6 +94,12 @@ formats is required. Implementing more than one format is optional.
 |----------------------------------------------|--------|--|----|---|------|----|------|---|----|---|----|-----|
 |TBD|
 
+## Logs
+
+|Feature                                       |Optional|Collector|Go|Java|JS |Python|Ruby|Erlang|PHP|Rust|C++|.NET|Swift|
+|----------------------------------------------|--------|---------|--|----|---|------|----|------|---|----|---|----|-----|
+|TBD|
+
 ## Resource
 
 | Feature                                                                                                                                     | Optional | Go | Java | JS | Python | Ruby | Erlang | PHP | Rust | C++ | .NET | Swift |

diff --git a/specification/logs/semantic_conventions/files.md b/specification/logs/semantic_conventions/files.md
@@ -0,0 +1,27 @@
+# Semantic Conventions for Log Files
+
+**Status**: [Experimental](../../document-status.md)
+
+This document describes attributes for log files in OpenTelemetry.
+
+<!-- Re-generate TOC with `markdown-toc --no-first-h1 -i` -->
+
+<!-- toc -->
+
+- [Log Files](#log-files)
+  * [`log_source.file.`](#log_sourcefile)
+
+<!-- tocstop -->
+
+## Log Files
+
+### `log_source.file.`
+
+**Description:** A file from which logs were read.
+| Name            | Description                                        | Value Type | Attribute Key  | Attribute Values     |
+| ----------------| -----------                                        | ---------- | -------------- | -------------------- |
+| log_source.file | The basename of the file                           | string     | name           | (identifier)         |
+|                 | The full path to the file                          | string     | path           | (identifier)         |
+|                 | The basename of the file, with symlinks resolved   | string     | type           | (identifier)         |
+|                 | The full path to the file, with symlinks resolved  | string     | mode           | (identifier)         |
+|                 | If applicable, the stream associated with the file | string     | stream         | stdout, stderr       |