Log API Troubleshooting guide
Yes, the Log API has Swagger support which comes complete with documentation, client SDK generation and discoverability. Swagger is a simple yet powerful representation of the RESTful API.
Swagger example for a Log Event
You can log any kind of data to the Log API however the main purpose is logging Business Transactions. With Nodinite you can provision self service to business critical data with role based access for your stakeholders. Smart filters (restrictions) can be applied to avoid potentially sensitive data from messages being revealed. This means the data you log should be logged for a reason. If you are strictly looking for technical logging without any concern for who reads and potentially further distributes content without leaving a single trace, then feel free to evaluate your options.
- Event - Generic information about the event (like time, messagetype name and endpoint) - WHEN, HOW
- Payload - The business transaction with data, usually xml, json, flatfile like EDI/X12 or zip file - WHAT
- Context Properties - Key value based collection of arbitrary data - (for example InvoiceId and CorrelationId) - WHAT
- With the Context Options you can control the behaviour of how Nodinite processes events
LogDateTime = 2018-05-03 13:37:00+02:00
EndPoint = https://api.nodinite.com/...
...] end subgraph "Payload" ro[fal:fa-envelope Message
base64EncodedMessage] end subgraph "Context Properties" roKey[fal:fa-key Key Values
InvoiceNo = 123
...] end end
Even though Nodinite is built to manage large messages (we have seen at least 5,5 GB payloads being logged) the Log API has limitations due to being an API. If you need large messaging support contact our support for guidance on how to properly manage your specific case.
The following protocols are supported:
Note: when using https the certificate must be valid when browsing the Log API
If the browser returns that the certificate is not secure, then the Log API will not work (since it can't be called upon).
You can write your own custom code that calls the Log API, below is a list of your options further detailed individually:
TIP: There are other asynchronous options available such as posting a Log Event to the filesystem or event better various queues. Use this in combination with the Pickup Service and you will have no dependency on Nodinite having to be available (which in turn means freedom to update Nodinite whenever you want).
The following list of Log Agents uses the Log API:
- BizTalk - Using pipeline components for Nodinite
- Log4Net - Add logging from Log4Net enabled applications
- Mulesoft Anypoint Logging - Use either the Log4J from Logger and Business Events (code) or even better with your own custom connector
- VB6/COM/VBScript - Log from VB6/VBScript code
- IBM Integration Bus Logging Agent - Get events and messages from IBM Integration Bus using IBM Monitor Events
Nodinite Log Agents are built to manage situations where the Log API is unavailable (usually due to updates, service windows with servers offline, or databases that has grown out of disk). The Log Agents will resume operation automatically whenever the Log API comes back online and is operational.