Instructions for connection
0
Check that you are using icecast
Mediastata service, only works with icecast media server log files.
Other media servers are not supported and we will not be able to connect them.
Other media servers are not supported and we will not be able to connect them.
NOTE: If you have hls, shoutcast or other broadcast server email us separately.
1
Select the method of data transfer
The Mediastata service supports 2 methods of receiving log files:
v1. Pull
You open access to data on your servers using any of the selected protocols
v2. Push
We open access on our server to receive data and you transmit it via ftp, http, rsyslog. In this option, we provide the requisites for uploading files. It is important that the upload takes place between 00:00-01:00 local time in order for all logs for the past 24 hours to be processed.
v1. Pull
You open access to data on your servers using any of the selected protocols
- ftp,
- http,
- rsyslog,
v2. Push
We open access on our server to receive data and you transmit it via ftp, http, rsyslog. In this option, we provide the requisites for uploading files. It is important that the upload takes place between 00:00-01:00 local time in order for all logs for the past 24 hours to be processed.
2
Post the status file
For real-time reporting, a status file must be placed in the Icecast web directory.
Status file download .
Post it to the Icecast web directory.
The path to the web directory can be found in the <path> section of the <webroot> section of the Icecast configuration file. The Icecast web directory is called web, and other status files such as status.xsl, status2.xsl, and others are also located there.
Status file download .
Post it to the Icecast web directory.
The path to the web directory can be found in the <path> section of the <webroot> section of the Icecast configuration file. The Icecast web directory is called web, and other status files such as status.xsl, status2.xsl, and others are also located there.
3
Allow access to log files
To the access.log files
Check that the name of the log file with listening data is named access.log or matches the masks access.log*, access.log.YYYYYMMDD*. By default Icecast forms file names in this form. If the file name is different, rename it to access.log* or access.log.YYYYYMMDD*.
To the playlist.log files
Check that the name of the radio station's broadcast metadata log file, which contains information on songs and artists played, is playlist.log. If the file name is different, rename it to playlist.log.
Important:
├── access.log
├── access.log.YYYYMMDD*
└── playlist.log.YYYYMMDD*
EDGE_2/
├── access.log
├── access.log.YYYYMMDD*
└── playlist.log.YYYYMMDD*
EDGE_3/
├── access.log
├── access.log.YYYYMMDD*
└── playlist.log.YYYYMMDD*
...
Here EDGE_1 and others are directories with arbitrary names, containing Icecast logs for a particular distributing server.
Check that the name of the log file with listening data is named access.log or matches the masks access.log*, access.log.YYYYYMMDD*. By default Icecast forms file names in this form. If the file name is different, rename it to access.log* or access.log.YYYYYMMDD*.
To the playlist.log files
Check that the name of the radio station's broadcast metadata log file, which contains information on songs and artists played, is playlist.log. If the file name is different, rename it to playlist.log.
Important:
- The path to the directory with log files can be viewed in the Icecast configuration file in the <path> section, under <logdir>.
- Make sure that the listening and metadata log files are not empty.
- If there are multiple broadcast servers, organize the files in this order:
├── access.log
├── access.log.YYYYMMDD*
└── playlist.log.YYYYMMDD*
EDGE_2/
├── access.log
├── access.log.YYYYMMDD*
└── playlist.log.YYYYMMDD*
EDGE_3/
├── access.log
├── access.log.YYYYMMDD*
└── playlist.log.YYYYMMDD*
...
Here EDGE_1 and others are directories with arbitrary names, containing Icecast logs for a particular distributing server.
4
Check the date and time on the server
Check that the time zone, current time and date on the server are set to the time in which you want to work in Mediastata.
Important:
Important:
- In most cases, this is your local time.
- For Linux systems, the time and time zone can be checked by running the date command
- For reliability, we recommend setting up time synchronization with ntp servers
- If you have multiple broadcast servers, the time on all servers should be the same.
5
Write an email after all the customizations have been made
Write a letter to the address an@mediastata.com
1
Name of radio station
Provide the original name of the radio station and in the Latin alphabet.
2
Data for accessing log files
Send data for access to log files by the selected method: server address, login, password.
3
Timezone
Specify your time zone so we can double-check.
4
Status file
Attach a link to the status file.
What's next?
In case of successful connection, we will send you a login and password by mail. Or we will send you technical questions in a reply e-mail.
In any case, we are always in touch. Write to us in a convenient way, if something will not work. We will definitely find a solution to make the necessary adjustments.
In any case, we are always in touch. Write to us in a convenient way, if something will not work. We will definitely find a solution to make the necessary adjustments.