Trace Log (tracelog)

Media Flow Controller includes a delivery trace facility to help diagnose the handling of a particular HTTP request. See tracelog for CLI details.

copy <SCP>

filename <name>

on-the-hour {disable | enable}

rotate {filesize-MB <integer> | time-interval <integer>}

syslog replicate {disable | enable}

The tracing is done by logging trace points of internal steps (e.g. namespace lookup, cache lookup, etc.). A request is traced if the following conditions are true:

•	The global trace flag is enabled via the CLI:

delivery protocol http trace enable

•	The HTTP request includes the X-NKN-Trace header; for example if using Wget:

wget --header “X-NKN-Trace:” <URL>

The HTTP modules detect the above conditions and set the flag “HRF_TRACE_REQUEST” as well as other flags that direct each relevant module to log meaningful trace points. The trace points (as of Release 2.0.2) given below are shown with variables that are instantiated with data before displaying:

OM=Origin Manager, SF=SmoothFlow, %s=string data, %d=integer data, %ld=long integer data.

The trace points described in Table 16 below, are currently (as of Release 2.0.2) defined in Media Flow Controller.

 

Table 16 Delivery Protocol HTTP Trace Points  

Trace Point	Description
“Object %s bytes %Id to %Id served from %s”	NFS trace.
"Unmount problem: Stale NFS handle %s"	NFS; the given NFS mount point is not valid
"Mount failed for mount command: %s"	NFS mount failed.
"Could not unmount old mount configuration. Please check whether someone is accessing this directory: %s"	NFS mount failed.
"Namespace configuration does not exist"	The requested namespace parameter is undefined
"URI prefix does not exist in namespace configuration"	The requested uri-prefix is not configured in the requested namespace.
"HTTP config does not exist in namespace configuration"	The requested namespace does not have HTTP delivery protocol or origin-server configured.
"Received TRACE URI: %s"	NFS trace.
"Programming error. Could not get URI " "postfix	NFS trace.
"Could not find the file in the " "directory. Please check filename: %s errno = %d"	The requested file was not found in the specified directory.
"Could not mount file. Please check " "filename: %s. errno = %d"	NFS; the requested file could not be mounted.
"End TRACE URI: %s. End NFS_stat. Success."	NFS.
"TRACE URI: %s. End NFS stat Error: URI not found"	NFS.
"End TRACE URI: %s. Error while doing STAT"	NFS.
"NFS GET: Received TRACE URI: %s"	NFS. Received trace URI
"NFS GET: Programming error: NFS object not found in get after stat succeeded"	NFS. Object not found
"NFS GET: Programming error: Error getting object after stat finished. "	NFS. Error getting object after stat finished.
"NFS GET: Cannot read content from file."	NFS. Requested content not in file.
"NFS GET: Cannot get attributes for this file”	NFS. Requested file attributes missing.
"NFS GET: TRACE URI: %s. End NFS get: Success"	NFS. Get successful.
"NFS GET: TRACE URI: %s. End NFS get: Error: Server busy"	NFS. Server busy.
"NFS GET: TRACE URI: %s. End NFS get: Error getting uri"	NFS. Error getting URI.
"OM returning %s bytes for object %s offset=%ld length=%ld"	Origin Manager. Returning cacheable/non-cacheable given bytes to the buffer manager for the given object starting at the given offset and length.
"OM connect failed %s:%hu for object %s"	Origin Manager. Unable to connect to the origin server identified by the given hostname/IP address and port for the given object.
"OM http_response object %s\n%s"	Origin Manager. HTTP origin server response for given object and headers.
"OM connect failed %s:%hu for object %s"	Origin Manager. Socket connect to the given IP address and port failed for the given object.
"OM gethostbyname_r(%s) failed"	Origin Manager. gethostbyname_r call failed for the given hostname/IP address with the given error code.
"OM connect(%s) failed”	Origin Manager. Socket connect to given hostname/IP address failed with the given error code.
"OM connecting %s:%hu for object %s"	Origin Manager. Socket connect to the given IP address and port is pending for the given object.
"Hash authentication failed for virtual player: %s"	Server Side Player. Video will not be delivered.
"Hash authentication successful for virtual player: %s"	Server Side Player. Video will be delivered.
"Fast start buffer size set to %d bytes"	Server Side Player. Configured fast--start value.
"Fast start not enabled"	Server Side Player. The fast-start option was requested but not enforced in the virtual player.
"AFR Set to %d Bytes/sec"	Server Side Player. assured-flow rate was set to the given value for delivering this video.
"AFR Failed. %d b/w unavailable for profile %s"	Server Side Player. The requested assured-flow rate was unable to be met due to a lack of bandwidth for a given video/profile; the video was not delivered since Media Flow Controller cannot honor the configured assured-flow rate.
"Virtual Player: %s of Type-%d has been invoked"	Virtual Player. Virtual player of the named type was invoked.
"No Virtual Player associated with this namespace"	Virtual Player. The requested virtual player option was unavailable because no virtual player is assigned to the requested namespace.
"Health probe request enabled and no cache flag is set"	Virtual Player. For this request, the fetched file will not be cached in Media Flow Controller.
"URL %s%s matched namespace %s"	Server Side Player. The incoming request was mapped to a configured namespace.
"URL %s%s did not match any namespace"	Server Side Player. The incoming request could not be mapped to any configured namespace.
"HTTP Response object %s\n%s"	HTTP Response object given.
"Logic for SmoothFlow state %d enabled"	The SmoothFlow feature has been configured correctly and is operating.
"[SesID: %s] Request to fetch internal meta file %s issued"	SmoothFlow trace; the internal meta file request was issued.
"[SesID: %s] SmoothFlow assets/metadata missing. Try to deliver regular file %s"	SmoothFlow trace; the meta file or some requested assets were not found, the default regular file will be delivered instead.
"[SesID: %s] SmoothFlow AFR Set: %d Bytes/sec"	SmoothFlow trace; assured-flow rate is set to given value.
"[SesID: %s] SmoothFlow AFR request failed: %d. Please check if network connection max bw is limiting AFR"	SmoothFlow trace; assured-flow rate request failed, possibly due to a lack of network bandwidth.
"AFR Failed, b/w unavailable"	Assured-flow rate could not be met due to lack of available bandwidth.