Streaming Log File Guidelines

In order to generate SoundExchange compliant reports, NPR Digital Services (NPR/DS) needs logs of all the requests for your streams during the reporting period. These raw streaming access logs are usually generated automatically by the software used to serve stream requests. They would be generated on the server from which the streams are served.

NPR DS must have access to the actual raw logs files – not aggregate statistics or counts – in order to properly calculate the statistics required to be reported to SoundExchange under the agreement worked out with the CPB.

We need these in a tab-delimited text file for processing. We cannot accept written logs, Word documents, PDF files or files that do not present the data in this format for processing.

Common streaming software packages include SHOUTcast, Icecast,Windows Media Player and QuickTime. In addition, if your streams are hosted by a third party vendor (e.g. Akamai, StreamGuys, Live365, etc.) they may generate their own streaming log file formats which need to be reformatted as below.

It’s possible that your software may need to be explicitly configured – or your vendor may require an explicit request – to generate these logs in this manner. Check with your host or vendor to ensure these logs are getting generated, at least during the reporting period you choose during each calendar quarter.

Also, some vendors may only keep these logs for a short period of time before deleting them. In this case NPR/DS can work with you and your vendor to obtain and archive the logs before they are deleted. Again, check with your host or vendor about this.
 

Required Data Fields Per Stream Request

STANDARD FILE FORMAT DETAILS

File type: tab delimited .txt

Do not combine logs; send separate files for each unique content stream

We will no longer accept data for two streams in 1 log file.

Columns (in order):

• IP address (#.#.#.#; Do NOT include port numbers (127.0.0.1:3600))

• Date listener tuned in (YYYY-MM-DD in this year-month-day with dash separation format)

• Time listener tuned in (HH:MM:SS; 24-hour military time; UTC time zone)

• Stream ID (No spaces, usually call letters eg. KTTT, WTTTHD1, etc.)

• Duration of listening (must be in seconds)

• HTTP Status Code (200's only please)

• Referrer/Client Player (Free text, anything user agent or referrer will work)

Finally, please be sure to let me know you have uploaded all your files by sending me a note at soundexchange@ds.npr.org