The queue_log file is normally located under /var/log/asterisk/. Each line in this file is to be considered as an event happened in the queues. The fields are separated by a pipe sign; here an example line:

The fields are, in order: timestamp of the event, unique id of the call, queue name, agent code, verb name, and up to 5 additional data fields which usage depends on the verb.

You can add custom lines in queue_log by calling Asterisk’s QueueLog() function.

The MOH events must be tracked during the call (between the CONNECT and the COMPLETEAGENT or COMPLETECALLER events); the CALLERONHOLD event is written when the call is put on hold, CALLEROFFHOLD when the call is resumed. These events are currently tracked by Uniloader, enabling the Unitracker feature.

IVR events must be tracked before the beginning of the call; here’s an example of IVR tracking with the IVRSTART and IVRAPPEND although you can find a detailed explaination here: Tracking IVR data

You can add a tag to a call (see Adding TAG information to calls), before, during and after the call itself, keeping in mind that if you run a report for a certain period of time only events happened in the report’s time window are shown. See Updating past calls.

A call can have only one tag, if multiple tag are added to the logs only the last one will be used.

Tags are added using the verb INFO. Here’s an example of tag added to the call after a few IVR choices:

A tag can be used in your CRM integration URL as follows: TAG

Refer to this page for additional details about this feature: CRM Integration

You can add a feature code to a call (Adding TAG information to calls), before, during and after the call itself, keeping in mind that if you run a report for a certain period of time only events happened in the report’s time window are shown. See also Updating past calls.

Feature codes are added using the verb INFO. Here’s an example of feature code added to the call after a few IVR choices; you can also see how a feature code can accept an additional free text field:

Existing feature codes can also be removed. QueueMetrics will report the complete history of added and removed feature codes in the call’s detail:

A feature code can be used in your CRM integration URL as follows: F:X1

Or you can just check if a feature code exists (outputs 1) or not (outputs 0): FX:X1

Refer to this page for additional details about this feature: CRM Integration

You can add custom variables to a call, before, during and after the call itself, keeping in mind that if you run a report for a certain period of time only events that happened in the report’s time window are shown. See Updating past calls.

Variables are added using the verb INFO. Here’s an example of variable added to the call:

A variable can be used in your CRM integration URL as follows: V:MY_VAR_NAME. Refer to this page for additional details about this feature: CRM Integration

If the same variable is present multiple times with different attributes, the last one wins.

If you want to track outbound calls you should create fake queue_log records as if the call was actually made in a queue. An outbound call is introduced by the CALLOUTBOUND verb. The called number will be tracked in the second additional field after the verb name (the first additional field is referred to the call’s URL). These events are currently tracked by Uniloader, enabling the Unitracker feature.

This is a valid outbound call:

QueueMetrics leaves you discern between the different kinds of pause your agents, in order to track also payable or billable activities. Pause codes are defined in the "Edit Pause codes" page (Configuring pause codes).

Using the PAUSEREASON verb immediately after the PAUSEALL verb you can add a pause code. In case of multiple PAUSEREASON verbs for the same pause only the most recent will be taken into consideration:

The call status will help you track the results of your calls. A call status can be added after the beginning of the call, and after the end of the call keeping in mind that if you run a report for a certain period of time only events happened in the report’s time window are shown. See Updating past calls.

In case of multiple call statuses only the last one is kept into consideration.

The call statuses are defined in the "Edit call outcomes" page (Configuring call outcomes)

Tracking the hotdesking events (Enabling Hotdesking in the agent page) just before the queue login events is very useful if you are using dynamic extensions in your call center. This will help QueueMetrics tracking the association between the agent code and the extension number used by that agent at any given moment:

In skill-based routing systems you can track the requested skills with the REQSKILL verb. (Configuring skills). These events are valid before the call is connected to the agent.