PrizmDoc® Viewer v13.28 Release - Updated
PrizmDoc Viewer / Administrator Guide / Error Reporting / Search Tips
In This Topic
    Search Tips
    In This Topic

    Introduction

    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.

    For Docker, for the remainder of this page, we assume that the folder that you mapped as /logs when creating the container is in the current directory (i.e. ./logs)

    On Windows

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

    On Linux Bash

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

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

    Example

    {"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 ./logs/PccErrors.log

    Example results from the query are shown below:

    Example

    {"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 ./logs/PccErrors.log

    Example results from the query are shown below:

    Example

    {"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 ./logs/WorkfileService.log

    Example results from the query are shown below:

    Example

    {"name":"WorkfileService","hostname":"ip-10-182-110-214","pid":7345,"taskid":24003,
    "gid":"Fa7Uay+IjZqa53pgSF9ueA","level":30,"type":"WorkfileRepository","contentsName":
    "/data/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":
    "/data/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":"/data/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: /data/cache/WorkfileCache/JAQ6o9ck1VM2ohFf5xiI6g/WorkfileContents.pdf".