Client Render Logs

The client sends a render log when it changes from one state to another. Each transition results in one log. This occurs, for example, when the client:

  • Pauses or stops a playing stream.

  • Fast forwards or rewinds a playing stream.

  • Stops a stream that is being fast forwarded or rewound.

  • Begins playing a stream that is being fast forwarded or rewound.

  • Reaches the end of a stream that is being fast forwarded or played.

  • Switches to the next item in the playlist from a stream that is being fast forwarded, rewound, or played.

Windows Media Player 9 Series also submits a render log if the content has been progressively streamed (fast cached to a temporary local file). A player that reads the file from the local cache submits a log when it has finished playing the content.

The following table contains the fields that make up a client render log. The fields are listed in the order in which they are logged.

Field name

Generated by

When generated

Description

Sample value

c-ip

Server

Start

IP address of the connected socket. This can be the IP of a proxy server or firewall. In previous versions of the server, the client supplied this field. The server now supplies it to respect the client's privacy.

157.100.200.300

or

3ffe:2900:d005:f28b:0000:5efe:157.55.145.142

Date

Server

Start

Date the client connected, in either UTC or local time, depending upon the plug-in configuration. Refer to the log file header to determine whether this value is UTC or local time.

1997-10-09

Time

Server

Start

Time the client connected to the stream, in either UTC or local time, depending upon the plug-in configuration. Refer to the log file header to determine whether this value is UTC or local time.

15:30:30

c-dns

Client

Start

DNS name of the client. This field is always empty. In previous versions of the server, the client supplied this field. This has changed to respect the privacy of the client.

-

cs-uri-stem

Client

Start

Path to the content requested by the client, without the schema, host, and port number.

/test/sample.wmv

or

/livebroadcast

c-starttime

Client

End

Time stamp (in seconds) indicating when the client began to play content. For live broadcasts, this field is zero (0).

39

x-duration

Client

End

Amount of time (in seconds) that the client has been playing content. Buffered data is not included. This value represents how much of the content the user receives even if the content is fast forwarded.

31

c-rate

Client

Dynamic

The last command event sent. Three events are possible (1= play, -5=rewind, +5= fast forward).

1

c-status

Client

Dynamic

Code describing the status of the client. 200 = Success. 210 = Client reconnected. 401 = Access denied. 400 = URL is not valid. 404 = Content not found. 408 = Request timeout. 420 = Reconnect failed. 500 = The server encountered an internal error and stopped streaming.

200

c-playerid

Client

Start

Client GUID. This can be a unique GUID if the user has not disabled unique identification. If the client is configured for anonymity, the GUID is reported as {3300AD50-2C39-46c0-AE0A-xxxxxxxxxxxx}) where x is the client's session ID (refer to the s-sessionid field). If the client is a distribution server, the GUID is filled with a series of zeros.

{c579d042-cecc-11d1-bb31-00a0c9603954}

or

anonymous:{3300AD50-2C39-46c0-AE0A-70B64F321A80}

c-playerversion

Client

Start

Version number of the player.

7.0.1024

c-playerlanguage

Client

Start

Language and country/region code of the player.

en-US

cs(User-Agent)

Client

Start

Browser type, if any, in which a player was embedded. If the player was not embedded, this field refers to the user agent of the client. Players based on the Windows Media Format 9 Series SDK include a parenthetical SDK version number. If a compatibility layer is used to map Windows Media Player version 6.4 to later versions, a WMPDXM tag is also appended.

Mozilla/4.0_(compatible;_MSIE_4.01;_Windows_98)

or

NSPlayer/6.4.1.2

or

PlayerApp(WMFSDK/9.0.1234)

or

Mozilla/4.0_(compatible;_MSIE_6.0;_Windows_NT_5.1)_(WMFSDK/9.0.0.2793)_WMPlayer/9.0.0.2793(WMPDXM)

cs(Referer)

Client

Start

Web page URL in which the player was embedded. If unknown, this field contains a hyphen (-).

http://www.xxx.yyy

or

c:\asfroot\test.wmv

or

\\server\share\welcome.asx

c-hostexe

Client

Start

Host application. For example, this can be a Web page in a browser (iexplore.exe), a Visual Basic applet (vb.exe), or stand-alone Windows Media Player (mplayer2.exe). This is the .exe file that the user executed. This cannot be a .dll, ocx or other file.

MPLAYER2.EXE

c-hostexever

Client

Start

Version number of the host application. The host application is the .exe file identified by c-hostexe.

6.2.5.323

c-os

Client

Start

Operating system on the client computer.

Windows_98

c-osversion

Client

Start

Version number of the operating system on the client computer.

4.10.0.1998

c-cpu

Client

Start

CPU on the client computer.

Pentium

filelength

Server

Start

File duration (in seconds). For a live stream this value is 0.

60

filesize

Server

Start

Size of the file (in bytes). For a live broadcast stream, this value is 0.

86000

Avgbandwidth

Server

End

Average bandwidth (in bits per second) at which the client is connected to the server. This is the average value for the duration of the connection.

102585

protocol

Server

Start

Protocol used to access the stream. For a client render log, this field is always "Cache".

MMST

transport

Server

Start

This field contains a hyphen (-).

-

audiocodec

Client

End

A semicolon-delimited list of audio codecs that encoded the audio streams that the client accessed. Each codec is only listed once, even if more than one stream was encoded using it.

Microsoft_Audio_Codec

or

Microsoft_Audio_Codec;Generic_MP3_Codec.

videocodec

Client

End

A semicolon-delimited list of video codecs that encoded the video streams that the client accessed. Each codec is only listed once, even if more than one stream was encoded using it.

Microsoft_MPEG-4_Video_Codec_V2

ChannelURL

Client

Start

URL to the multicast information (.nsc) file. This field contains a hyphen (-) for a unicast stream unless the stream is the result of a unicast rollover from a multicast stream.

https://server/channel.nsc

sc-bytes

Server

End

This field contains a hyphen (-).

-

c-bytes

Client

End

This field contains a hyphen (-).

-

s-pkts-sent

Server

End

This field contains a hyphen (-).

-

c-pkts-received

Client

End

This field contains a hyphen (-).

-

c-pkts-lost-client

Client

End

This field contains a hyphen (-).

-

c-pkts-lost-net

Client

End

This field contains a hyphen (-).

-

c-pkts-lost-cont-net

Client

End

This field contains a hyphen (-).

-

c-resendreqs

Client

End

This field contains a hyphen (-).

-

c-pkts-recovered-ECC

Client

End

This field contains a hyphen (-).

-

c-pkts-recovered-resent

Client

End

This field contains a hyphen (-).

-

c-buffercount

Client

End

This field contains a hyphen (-).

-

c-totalbuffertime

Client

End

This field contains a hyphen (-).

-

c-quality

Client

End

Because the content is played from local cache, this field is always 100 for a client render log.

100

s-ip

Server

Begin

IP address of the server that received the client log.

155.12.1.234

s-dns

Server

Begin

Domain Name System (DNS) name of the server that received the client log.

media.server.company.com

s-totalclients

Server

End

Number of clients connected to the server when a logging event is sent.

20

s-cpu-util

Server

End

Average load on the server cpu(s) on a scale from 0 to 100.

40

cs-user-name

Server

Begin

This field contains a hyphen (-).

-

s-session-id

Server

Begin

This field contains a hyphen (-).

-

s-content-path

Server

Begin

This field contains a hyphen (-).

-

cs-url

Client

Begin

URL requested by the client. For multicast clients, this value is the multicast IP address and port.

mms://microsoft.com/content.wmv

asfm://206.73.118.254:26502

cs-media-name

Client

End

Name of the stream rendered by the client. This can be the name of the current element in a playlist. If the client received content from a playlist, the value is derived from the mediaName attribute of the media element. If the mediaName attribute is not present, the value in this field is the name of the file that was streamed.

Only Windows Media Player 9 Series supports this field.

/ads/MyAd2.wmv

c-max-bandwidth

Client

End

Maximum client bandwidth, in bits per second. You can use this to determine whether clients have the capacity for higher bandwidth content. This field can have the following values: a) the number of bits per second reported from the client. b) an undetermined amount, logged as 0. c) a very large number of bits per second that cannot be accurately measured but is greater than one million and less than one billion, logged as a hyphen (-). d) a hyphen (-) when a file is being played from the local cache and no bandwidth is used.

384000

cs-media-role

Client

End

The value assigned to the role attribute for a media element in a playlist. This value indicates the role that the playlist entry performs, such as an advertisement. If the media element did not have a role attribute, or if the client did not receive content from a playlist, this field contains a hyphen (-).

ADVERTISEMENT

s-proxied

Server

End

If this field is one (1), the client connection was made through a cache proxy server. Otherwise, it is zero (0).

1

See Also

Concepts

Log Types