Appendix F: ESAM Agent Log Reference

this guide is broken into sections where the log messages are found within the agent not all logs are defined here as they’re triggered by the network or external systems for messages in the log file that are not referenced here, consult zen master engineering team the log levels used are warn, error, info, debug general log navigation every event will have an acquisitionsignalid generated with the signal processing event for solicited events and signal processing notification for unsolicited this acquistionsignalid will appear on every subsequent log event until that event is complete if you find any log line related to an action in question and ‘grep’ the log using the acquisitionsignalid, you will return the entire flow from scte acquisition to source switch/pois insertion and broadcaster response signal handler (solicited) variables {{text}} = variable (listed below) \<text> = info from another return in the agent identifiers = acquisitionsignalid, streamid, output id, zoneidentity decision = acquisitionsignalid, zoneidentity, acquisitionpointidentity, altcontent, altcontentidentity, utcpoint level message description debug signalhandler called with streamid \<input stream id> notification that a new scte 35 message came in on the provided streamid debug signalhandler input is not esam relevant \<input stream id> the input where the scte 35 was captured does not have an esam id debug signalhandler no outputs found for streamid \<input stream id> there are no outputs connected to the input were the scte 35 was captured info signalhandler called with streamid \<input stream id> outputs {output id, output name, output zoneidentity} all outputs attached to the input where the scte 35 was captured debug signalhandler processing output (signalprocessingevent) {{identifiers}} informative message about output that is being processed debug signalhandler parseddecision {decision}, {{identifiers}} sds response for processed output error signalhandler error requesting decision, \<error msg>, {{identifiers}} error getting decision from sds info signalhandler no altcontent element in decision; no switch required {{identifiers}} error getting decision from sds warn signalhandler no matching input for altcontentidentity \<alt content from {decision}> {{identifiers}} the alternate identity provided in the sds response does not exist on the broadcaster error invalid inputid altcontentidentity field in config set incorrectly debug signalhandler skipping output on matching input \<output stream id> {{identifiers}} the output being processed is already connected to the alternate content input info signalhandler processing output (switching) {{identifiers}} { currentinputid \<output stream id>, newinputid \<newinput id>, \<adjustedptstime>} a switch command is being sent to the broadcaster to switch the input connected to the output error signalhandler error processing event \<error msg> {{identifiers}} general error while processing the response from the sds unsolicited handler {{text}} = variable (listed below) \<text> = info from another return in the agent identifiers = acquisitionsignalid, streamid, output id, zoneidentity outputidentifiers = {{identifiers}}, outputid output id, outputname output name level message description info unsolicitedhandler called with {{identifier}} informative message that unsolicited message was received warn unsolicitedhandler no switch required {{identifiers}} alternate content element of sds message is missing or set to false warn unsolicitedhandler no input found by altcontentidentity {{identifiers}} no input was found on the broadcaster with the id provided in the altcontentidentity of the sds message debug unsolicitedhandler skipping output on matching input \<output stream id> {{identifiers}} the output and input in the sds message are already connected warn unsolicitedhandler no outputs found by zoneidentity {{identifiers}} the output provided in the sds message is not available on the broadcaster info unsolicitedhandler processing output (switching) {{outputidentifiers}} a switch command is being sent to the broadcaster to switch the input connected to the output error unsolicitedhandler error processing event {{outputidentifiers}}\<error msg> general error while switching input and updating zen master broadcaster api/client \<text> = info from another return in the agent level message description error timeout timeout interacting with the broadcaster api error broadcasterapi get, error \<error msg> error interacting with the broadcaster api error broadcaster api error2 \<error msg> error interacting with the broadcaster api (json format) error bx error \<error msg> error switching inputs on broadcaster info broadcaster redirect response \<response message> response message from broadcaster after input switch info broadcasterclient enablesctereporting, scte reporting applied successfully scte 35 reporting url is set to send messages to the esam agent error broadcasterclient enablesctereporting, error enabling scte reporting \<error msg> problem updating the scte 35 reporting url on the broadcaster error broadcasterclient getsettings, error getting settings \<error msg> problem getting broadcaster config file through the api error broadcasterclient getoutputs, no outputs found no outputs on the broadcaster error broadcasterclient getoutputs, no esam relevant outputs found no outputs with esam ids on the broadcaster error no inputs found no inputs on the broadcaster error no esam supported inputs found no inputs with esam ids on the broadcaster sds (signal decision service) \<text> = info from another return in the agent level message description error error sending acknowledgement \<error msg> problem sending the response message to the sds debug === signalprocessingevent === header for next log debug \<spe message> unformatted message to sds debug = signalprocessingnotification = header for next log debug \<spn message> formatted response from sds error error parsing decision \<error msg> problem parsing message from sds error invalid sds decision \<error msg> problem parsing message from sds debug sdsclient acknowledgement \<psn message> unformatted message to sds error error sending acknowledgement \<error msg> problem sending the status message to the sds config manager \<text> = info from another return in the agent level message description error config file /config json not found, see /config templage json for an example the esam agent is unable to find the config json file error error reading /config json \<error msg> the esam agent is unable to read the config file error error parsing /config json \<error msg> validation error for xml helper functions {{text}} = variable (listed below) \<text> = info from another return in the agent ptstime = pts time of the splice point in the scte 35 message preroll = pre roll (if provided) in the scte 35 segmentation descriptors adjusterptstime = ptstime + preroll level message description error invalid xml data type is not string validation error for xml error failed to parse xml problem parsing the xml provided debug parsed pts { {{ptstime}}, {{preroll}}, {{adjustedptstime}} } ptstime, preroll, and adjustedptstime from scte 35 error error parsing pts \<error msg> problem parsing pts and preroll from scte 35 message error invalid request \<error msg> validation error for xml http client \<text> = info from another return in the agent level message description error requesthandler error \<request method> , \<url>, \<request body> problem requesting data from external system error error fetching data \<error msg> problem requesting data from external system warn retryhandler, attempt \<attempt number> failed \<last error> problem, attempting another retry monitor \<text> = info from another return in the agent level message description warn monitor, no broadcaster detected no response from broadcaster getsettings api call error monitor, scte messages not enabled broadcaster scte 35 report url not configured for esam agent error error in monito \<error msg> problem checking or configuring broadcaster scte 35 report url zen master client \<text> = info from another return in the agent level message description info zenmasterclient updatezenmaster, switching targets zen master will be notified of a input output switch info zenmasterclient updatezenmaster, zen master has been updated successfully zen master successfully reassigned the channel to the target error error updating zen master \<error msg> zen master was unsuccessful in reassigning the channel to the target info reportscte35, scte35 posted to zen master \<response status> response message from zen master after posting scte 35 message error reportscte35, failed to post scte35 to zen master \<error msg> problem posting scte 35 message to zen master app (main) \<text> = info from another return in the agent level message description error error processing unsolicited request \<error msg> general error processing unsolicited message error error processing signal \<error msg> general error processing solicited message info server is running on localhost \<tcp port> startup message noting the tcp port the agent is listening on error failed to start server \<error msg> general error starting esam agent