From 27430c8d589096b16e5f95ec0e87f904ed7655bb Mon Sep 17 00:00:00 2001 From: Dan Jaglowski Date: Tue, 2 Nov 2021 16:47:20 -0400 Subject: [PATCH] Explain expected usage of log body --- specification/logs/data-model.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/specification/logs/data-model.md b/specification/logs/data-model.md index d5c7057157e..c5b58473933 100644 --- a/specification/logs/data-model.md +++ b/specification/logs/data-model.md @@ -398,8 +398,10 @@ Type: any. Description: A value containing the body of the log record (see the description of `any` type above). Can be for example a human-readable string message (including multi-line) describing the event in a free form or it can be a -structured data composed of arrays and maps of other values. Can vary for each -occurrence of the event coming from the same source. This field is optional. +structured data composed of arrays and maps of other values. First-party +Applications SHOULD use a string message. However, a structured body may be +necessary to preserve the semantics of some existing log formats. Can vary for +each occurrence of the event coming from the same source. This field is optional. ### Field: `Resource`