...
A Mapped Diagnostic Context (MDC) allows an arbitrary string-valued attribute to be attached to a Java thread via a ThreadLocal variable. The MDC's value is then emitted with each message logged by that thread. The set of MDCs associated with a log message is serialized as unordered name-value pairs (see Text Output 71831758).
A good discussion of MDCs can be found at https://logback.qos.ch/manual/mdc.html.
...
- Must be set as early in invocation as possible.
- Must be unset on exit.
- keep in sync with https://wiki.acumos.org/display/OAM/Log+Standards
Legend |
---|
Green = Required field |
Yellow = Optional field |
Pipe Order | Name | Type | Group | Description | Applicable (per log file) | Marker Associations | Required? Y/N/C (C= context dependent) N = not required L=Library provided | Derived | Historical | Acumos ref | Use CasesNotes | Code References | |||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
1 | LogTimestamp | log system | use %d field - see %d{"yyyy-MM-dd'T'HH:mm:ss.SSSXXX",UTC} | L | |||||||||||
2 | EntryTimestamp | MDC | if part of an ENTRY marker log | C | |||||||||||
3 | InvokeTimestamp | MDC | if part of an INVOKE marker log | C | |||||||||||
4 | RequestID | MDC | UUID to track the processing of each client request across all the ONAP components involved in its processing | Y | In general | ||||||||||
5 | InvocationID | MDC | UUID correlates log entries relating to a single invocation of a single component In the case of an asynchronous request, the InvocationID should come from the original request | Y | See the comment section of the v1.2 spec spec on July 23, 2019 | ||||||||||
6 | InstanceID | MDC | UUID An unique ID to differentiate between multiple instances of the same (named) log writing service/application. For example, either the Kubernetes pod ID or UUID can be used for this field. | Y | was InstanceUUID | Was InstanceUUID | |||||||||
7 | ServiceInstanceID | MDC | An unique identifier of a newly instantiated network service instance. | 7 | ServiceInstanceID | MDC | C | ||||||||
8 | thread | log system | use %thread field | L | |||||||||||
9 | ServiceName | MDC | The service inside the partner doing the call - includes API name | Y | |||||||||||
10 | PartnerName | MDC | The identification of the entity that made the request being served. For a serving API that is authenticating the request, this should be the authenticated username or equivalent (e.g. an attuid or a mechid)
authenticated = userid
| Y | user | See the comment section of the v1.2 spec spec on August 6, 2019 | |||||||||
11 | StatusCode | MDC | This field indicates the high level status of the request - one of (COMPLETE, ERROR, INPROGRESS) | Y | 20180807: expand from 2 fields to add "INPROGRESS" addresses Chris Lott question on https://wiki.acumos.org/display/OAM/Log+Standards | ||||||||||
12 | ResponseCode | MDC | This field contains application-specific error codes. In the case where | Y | |||||||||||
13 | ResponseDesc | This field contains a human readable description of the ResponseCode | Y | ||||||||||||
14 | level | %level | L | ||||||||||||
15 | Severity | MDC | Logging level by default aligned with the reported log level - one of INFO/TRACE/DEBUG/WARN/ERROR/FATAL | Y | level (but numbers) | ||||||||||
16 | ServerIPAddress | C | |||||||||||||
17 | ElapsedTime | C | |||||||||||||
18 | ServerFQDN | MDC | The VM FQDN if the server is virtualized. Otherwise the host name of the logging component. | Y | |||||||||||
19 | ClientIPAddress | MDC | This field contains the requesting remote client application’s IP address if known. Otherwise empty. | Y | |||||||||||
ServerFQDN supercedes VirtualServerName as mentioned in the comment section of the v1.2 spec on July 3, 2019.
| |||||||||||||||
21 | ContextName | C | The logging enhancement team could not find any definition for this field and it was agreed to leave out the description for this field. See comment section of the v1.2 spec on July 23, 2019. | ||||||||||||
22 | TargetEntity | MDC | The name of the ONAP component or sub-component, or external entity, at which the operation activities captured in this metrics log record is invoked. | C | |||||||||||
23 | TargetServiceName | MDC | The name of the API or operation activities invoked (name on the remote/target application) at the TargetEntity. | C | |||||||||||
24 | TargetElement | MDC | VNF/PNF context dependent - on CRUD operations of VNF/PNFs The IDs that need to be covered with the above Attributes are
| C | |||||||||||
25 | User | MDC | User - used for %X{user} | C | |||||||||||
26 | p_logger | log system | The name of the class doing the logging (in my case the ApplicationController – close to the targetservicename but at the class granular level - this field is %logger | L | |||||||||||
27 | p_mdc | log system | allows forward compatability with ELK indexers that read all MDCs in a single field - while maintaining separate MDCs above. The key/value pairs all in one pipe field (will have some duplications currently with MDC’s that are in their own pipe – but allows us to expand the MDC list – replaces customvalue1-3 older fields - this field is %mdc | L | |||||||||||
28 | p_message | log systemThe marker labels INVOKE, ENTRY, EXIT – and later will also include DEBUG, AUDIT, METRICS, ERROR when we go to 1 log file - this field is %marker | Standard attribute - defined in logback.xml - Message - used for %msg% | L | |||||||||||
29 | p_marker | log system | The marker labels INVOKE, ENTRY, EXIT – and later will also include DEBUG, AUDIT, METRICS, ERROR when we go to 1 log file - this field is %marker | L |
...
supercedes virtualServerName
Report what is in the http header
Report what is in the http header
Discussion: roll all 3 fqdn, hostname or ip into one field - do we ever need two of the 3 fields concurrently?
Dave Williamson We seem to cover well what to put in this field in bare metal and virtualized environments, but I think we have not managed to come to closure as to what we should put in containerized environments. I would suggest that in all environments we simply ask that whatever "hostname" reports be logged in this field.Discussion: roll all 3 fqdn, hostname or ip into one field - do we ever need two of the 3 fields concurrently?
- TODO: Verify what is also available from a filebeat agent when it exists
...
Used as valuable URI - to annnote invoke marker
Review in terms of Marker 71831758 - INVOKE - possiblly add INVOKE-return - to filter reporting
...
Retention
Types of EELF Logs
Excerpt |
---|
New ONAP Component ChecklistAdd this procedure to the Project Proposal Template By following a few simple rules:
Obligations fall into two categories:
You must:
|
...
|
...
|
...
|
...
They are unordered. |
What's New
TBD
(Including what WILL be new in v1.2 / R2).
...