-
Notifications
You must be signed in to change notification settings - Fork 42
Logging Message ID Rules
The App framework's logger allows for messages to have IDs which can be used to find the right version of a message for foreign languages or just as a way to quickly find documentation for a message. It is detailed here:
https://github.com/zowe/zlux/wiki/Logging#logger-message-substitution-using-ids
The IDs are per-logger, where loggers for plugins are automatically made and given to the plugin code at runtime. During that time, the messages that map to each ID is found in a JSON file relative to the plugin & part of the plugin. All router dataservices share a file, and the web code has another file.
Logs always include the name of the plugin, but it is good practice to make the IDs be unique relative to other software. For example, all of Zowe's own code has IDs starting with ZWE. These are documented here:
https://github.com/zowe/zlc/blob/master/process/messageManagement.md
All code in the app server or app framework should start with ZWED, have 4 numbers, and a letter at the end signifying the level of message. Therefore the format is ZWEDnnnnL where the n is number, and the L is level. Levels such as I for info, W for warning, and E for error are expected.
Server-side code should have a number between 0000 and 4999, whereas web code can be between 5000 and 9999. This is to make it easier to prevent accidental duplication.
Messages must be added in specific places relative to the part of the codebase, explained below.
NOTE: There should be no duplication of ZWED IDs among the framework because it will make documentation wrong
If you are editing web code (/web or /webClient), then at runtime the file must be located at
PLUGIN/web/assets/i18n/messages_LANG.json
Such as: /web/assets/i18n/messages_en.json for english.
Router (javascript) dataservices can have their message files at
PLUGIN/lib/assets/i18n/log/messages_LANG.json
The app server is not a plugin, and therefore has its logs in a specific place. The message file is here:
https://github.com/zowe/zlux-server-framework/blob/master/lib/assets/i18n/log/messages_en.json
The app manager also has parts that are not plugins, such as the dispatcher code found in zlux-platform, or the bootstrap code. For these, we use the bootstrap plugin's web JSON files, such as the English one at
/zlux-app-manager/bootstrap/web/assets/i18n/messages_en.json
NOTE: Plugins do not need to share the same ZWED prefix that the framework MUST share, but some parts of the framework are organized as plugins, such as zlux-app-manager/virtual-desktop being a plugin.