Topic Last Modified: 2012-07-02

The Failure List report provides information about the individual participants who took part in a failed peer-to-peer or conferencing session. This information includes the URI of the user who experienced the problem, as well as the SIP Response code and Diagnostic ID associated with the failure.

Accessing the Failure List Report

The Failure List Report is accessed by clicking any of the following metrics on the Failure Distribution Report:

  • Top diagnostic reasons (sessions)

  • Top modalities (sessions)

  • Top pools (sessions)

  • Top sources (sessions)

  • Top components (sessions)

  • Top from users (sessions)

  • Top to users (sessions)

  • Top from user agents (sessions)

From the Failure List Report you can access the Peer-to-Peer Session Detail Report by clicking the Session detail metric for a peer-to-peer session. You can also access the Conference Detail Report by clicking the Conference metric for a conference.

Making the Best Use of the Failure List Report

In the Failure List Report, you can view a description for each Response code or each Diagnostic ID simply by holding your mouse over that value. For example, if you hold your mouse over Diagnostic ID 7025 you'll see the following displayed in a tooltip:

Internal server error creating media for user.

It's important to note that the Failure List Report does not provide a straightforward way to directly retrieve a list of all the users who participated in at least one failed session, nor does it provide a way to determine which users were most-often involved in a failed session. (For one thing, the Failure List Report has no filtering capabilities.) However, if you export the data and then convert it to a comma-separated values file, you can use Windows PowerShell to find the answers to questions like those. For example, suppose you save the data to a .CSV file named C:\Data\Failure_List.csv. Based on the data saved in that file, this command lists all the users who were involved in at least one failed session:

Copy Code
$failures = Import-Csv -Path " C:\Data\Failure_List.csv"
$failure |Sort-Object "From user" | Select-Object "From user" -Unique

That command will return a list similar to this:

Copy Code
From user
----
Pilar.Ackerman@litwareinc.com
Henrik.Jensen@litwareinc.com
Gilead.Amosnino@litwareinc.com
David.Ahs@litwareinc.com
Ken.Myer@litwareinc.com

These two commands report back the total number of failed sessions that each user was involved in:

Copy Code
$failures = Import-Csv -Path "C:\Data\Failure_List.csv"
$failures | Group-Object "From user" | Select-Object Count, Name | Sort-Object -Property Count -Descending

That will return data similar to this:

Copy Code
Count	Name
 -----	----
	20	Pilar.Ackerman@litwareinc.com
	20	David.Ahs@litwareinc.com
	16	Gilead.Amosnino@litwareinc.com
	16	Ken.Myero@litwareinc.com
	14	Henrik.Jensen@litwareinc.com

Filters

None. You cannot filter the Failure List Report.

Metrics

The following table lists the information provided in the Failure List Report for each failed call.

Failure List Report Metrics

Name Can you sort on this item? Description

Reported time

No

Date and time the report was recorded.

Request

No

SIP request type that failed. For example, INVITE or BYE.

Response code

No

SIP response code sent when the conference failed.

Diagnostic ID

No

Unique identifier (in the form of an ms-diagnostics header) attached to a SIP message that often provides information useful in troubleshooting errors.

Join cost time (ms)

No

Amount of time (in milliseconds) required for the user to join the conference.

From user

No

SIP address of the user who initiated the call.

From user agent

No

Software used by the endpoint of the user who initiated the call.

To user

No

SIP address of the user who was being called.