PrizmDoc v13.0 - Updated
Search Tips
Administrator Guide > Troubleshoot > Error Reporting > Search Tips

The examples below show methods for locating errors in the Error Reporting Service logs. While the examples here use command-line based searches, the same results can be achieved with your favorite text editor or other search tool.

Searching for a Specific Relevance

Errors that can be resolved directly by a user will have a high relevance (typically 90 or 100). It is useful to filter the PccErrors.log for entries with a specific relevance. The examples below show command line operations to list errors with relevance 100 on both Windows and the Linux Bash shell.

On Windows:

C:\> findstr /L "relevance\":100" C:\ProgramData\Accusoft\Prizm\Logs\PccErrors.log

On Linux Bash:

$> grep 'relevance":100' /usr/share/prizm/logs/PccErrors.log

An example of an entry with relevance 100 is shown below:

Example
Copy Code
{"gid":"13CbzVdHZ/wqVKLCZmfq9A","time":"2015-05-14 
19:26:25.9842","resourceType":"ViewingSession","resourceId":"190054e9-574f-4b83-ae86-
d30c0c7e2c1c","relevance":100,"errorCode":"DocumentRequiresAPassword","service":
"ImagingServices","errorId":"3SgxE5MseBEolbECEMSETA"}

In this case, the user has attempted to view a document requiring a password without providing the password.

Searching for a Viewing Session

If an error occurs during a particular viewing session, the cause of the problem may be reported in the Error log. The errors for a particular viewing session can be found first by searching for the viewing session ID.

On Windows:

C:\> findstr /L "sugq5PRxDV4ERAbaQLgpRzKjbKrHp868m6zN2QG-wBFHO3ZX-SIhJ3GIJA8FK4WZzB2DjiJ_gZWTAUdyKeqBcw" C:\ProgramData\Accusoft\Prizm\Logs\PccErrors.log

On Linux Bash:

$> grep sugq5PRxDV4ERAbaQLgpRzKjbKrHp868m6zN2QG-wBFHO3ZX-SIhJ3GIJA8FK4WZzB2DjiJ_gZWTAUdyKeqBcw /usr/share/prizm/logs/PccErrors.log

Example results from the query are shown below:

Example
Copy Code
{"gid":"13CbzVdHZ/wqVKLCZmfq9A","time":"2015-05-14 19:26:25.9834","resourceType":"ViewingSession","resourceId":
"sugq5PRxDV4ERAbaQLgpRzKjbKrHp868m6zN2QG-wBFHO3ZX-SIhJ3GIJA8FK4WZzB2DjiJ_gZWTAUdyKeqBcw","relation":
"ViewingSessionId","relationResourceId":"190054e9-574f-4b83-ae86-
d30c0c7e2c1c","service":"ImagingServices","relationId":"HsayMuoWcABqBDsN6yR9Vg"}

Notice the second ID: "190054e9-574f-4b83-ae86-d30c0c7e2c1c". This is the internal ID for a viewing session. A search for this ID will locate any errors associated with the viewing session.

Searching for Related Resources

After a record has been identified, it is useful to determine if any related error records were reported.  This can be achieved by searching the log for the resource ID.

On Windows:

C:\> findstr /L "190054e9-574f-4b83-ae86-d30c0c7e2c1c" C:\ProgramData\Accusoft\Prizm\Logs\PccErrors.log

On Linux Bash:

$> grep 190054e9-574f-4b83-ae86-d30c0c7e2c1c /usr/share/prizm/logs/PccErrors.log

Example results from the query are shown below:

Example
Copy Code
{"gid":"13CbzVdHZ/wqVKLCZmfq9A","time":"2015-05-14 
19:26:25.9842","resourceType":"ViewingSession","resourceId":"190054e9-574f-4b83-ae86-
d30c0c7e2c1c","relevance":100,"errorCode":"DocumentRequiresAPassword","service":"ImagingServices","errorId":
"3SgxE5MseBEolbECEMSETA"}

{"gid":"13CbzVdHZ/wqVKLCZmfq9A","time":"2015-05-14 
19:26:25.9834","resourceType":"ViewingSession","resourceId":"sugq5PRxDV4ERAbaQLgpRzKjbKrHp868m6zN2QG-wBFHO3ZX-
SIhJ3GIJA8FK4WZzB2DjiJ_gZWTAUdyKeqBcw","relation":"ViewingSessionId","relationResourceId":"190054e9-574f-4b83-ae86-
d30c0c7e2c1c","service":"ImagingServices","relationId":"HsayMuoWcABqBDsN6yR9Vg"}

{"gid":"13CbzVdHZ/wqVKLCZmfq9A","time":"2015-05-14 19:26:25.9843","resourceType":
"ViewingSession","resourceId":"190054e9-574f-4b83-ae86-
d30c0c7e2c1c","relation":"SourceDocumentWorkFile","relationResourceId":"JAQ6o9ck1VM2ohFf5xiI6g","service":
"ImagingServices","relationId":"nXI4pNPhXmS2Idb8vui1LQ"}

Notice the third record: "JAQ6o9ck1VM2ohFf5xiI6g". This reported relation record indicates the workfile requiring the password. Now that the workfile ID has been identified, it is possible to determine the actual file from the WorkfileService.log.

Searching Other Logs

Once the workfile ID is known, it possible to search WorkfileService.log for location of the actual file which caused the error.

On Windows:

C:\> findstr /L JAQ6o9ck1VM2ohFf5xiI6g C:\ProgramData\Accusoft\Prizm\Logs\WorkfileService.log

On Linux Bash:

$> grep JAQ6o9ck1VM2ohFf5xiI6g /usr/share/prizm/logs/WorkfileService.log

Example results from the query are shown below:

Example
Copy Code
{"name":"WorkfileService","hostname":"ip-10-182-110-214","pid":7345,"taskid":24003,
"gid":"Fa7Uay+IjZqa53pgSF9ueA","level":30,"type":"WorkfileRepository","contentsName":
"/usr/share/prizm/cache/WorkfileCache/JAQ6o9ck1VM2ohFf5xiI6g/WorkfileContents.pdf","msg":
"Creating content write stream","time":"2015-05-14T19:26:25.872Z","v":0}

{"name":"WorkfileService","hostname":"ip-10-182-110-214","pid":7345,"taskid":24003,
"gid":"Fa7Uay+IjZqa53pgSF9ueA","level":30,"type":"WorkfileRepository","workfile":
"/usr/share/prizm/cache/WorkfileCache/JAQ6o9ck1VM2ohFf5xiI6g/WorkfileContents.pdf","msg":
"Workfile content created","time":"2015-05-14T19:26:25.872Z","v":0}

{"name":"WorkfileService","hostname":"ip-10-182-110-214","pid":7345,"taskid":24003,
"gid":"Fa7Uay+IjZqa53pgSF9ueA","level":30,"reqBegin":true,"req":{"method":"POST","path":"/FDS/detect",
"port":38503,"data":{"src":"/usr/share/prizm/cache/WorkfileCache/JAQ6o9ck1VM2ohFf5xiI6g/WorkfileContents.pdf"}},
"msg":"","time":"2015-05-14T19:26:25.872Z","v":0}

{"name":"WorkfileService","hostname":"ip-10-182-110-214","pid":7345,"taskid":24004,
"gid":"13CbzVdHZ/wqVKLCZmfq9A","level":30,"taskBegin":true,"parent":{"name":"PCCIS","pid":8130,
"taskid":2519},"reqAccepted":true,"req":{"method":"GET","path":"/PCCIS/V1/WorkFile/JAQ6o9ck1VM2ohFf5xiI6g",
"port":19020},"msg":"","time":"2015-05-14T19:26:25.908Z","v":0}

{"name":"WorkfileService","hostname":"ip-10-182-110-214","pid":7345,"taskid":24004,"gid":"13CbzVdHZ/wqVKLCZmfq9A","level":30,"type":"WorkfileService",
"workfileId":"JAQ6o9ck1VM2ohFf5xiI6g","msg":"Begin: getWorkfile","time":"2015-05-14T19:26:25.908Z","v":0}

{"name":"WorkfileService","hostname":"ip-10-182-110-214","pid":7345,"taskid":24004,"gid":"13CbzVdHZ/wqVKLCZmfq9A","level":30,"type":
"WorkfileService","workfile":{"id":"JAQ6o9ck1VM2ohFf5xiI6g","expirationDateTime":"2015-05-
15T19:26:25.871Z","fileExtension":"pdf","_version":1,"cacheEnabled":false,"fileFormat":"pdf"},
"msg":"Workfile retrieved","time":"2015-05-14T19:26:25.908Z","v":0}

The following section in the record shows the location of the file: /usr/share/prizm/cache/WorkfileCache/JAQ6o9ck1VM2ohFf5xiI6g/WorkfileContents.pdf".