Working with PrizmDoc > Administering PrizmDoc > Troubleshooting > 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.
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.
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.
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.
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".