com.pdftron.server.HeartbeatException: heartbeat: failed for job

WebViewer Version: 10.9
WebViewer Server Version: 2.2.2

Do you have an issue with a specific file(s)? No
Can you reproduce using one of our samples or online demos?
Are you using the WebViewer server? Yes
Does the issue only happen on certain browsers? No
Is your issue related to a front-end framework? No
Is your issue related to annotations? No

Please give a brief summary of your issue:

Repeated errors in logs: “com.pdftron.server.HeartbeatException: heartbeat: failed for job”

Please describe your issue and provide steps to reproduce it:

I’ve deployed the pdftron/webviewer-server:2.2.2 docker image to a Cloud Run instance on Google Cloud Platform.

I see dozens of Heartbeat Exceptions and I’m not sure what’s causing them (or what the effect is)

java.util.concurrent.ExecutionException: com.pdftron.server.HeartbeatException: heartbeat: failed for job - 9f2f844d-cf37-4a99-bef4-46560a202378

at java.util.concurrent.CompletableFuture.reportGet ( java/util.concurrent/ )
at java.util.concurrent.CompletableFuture.get ( java/util.concurrent/ )
at com.pdftron.server.BlackBoxPoller.waitForResult ( com/pdftron.server/ )
at com.pdftron.server.BlackBoxExecutor.sendJobAndWait ( com/pdftron.server/ )
at com.pdftron.server.BlackBoxClient.doOperation ( com/pdftron.server/ )
at com.pdftron.server.Operation.doDocOperation ( com/pdftron.server/ )
at com.pdftron.server.TypeOperation$Render.doOperation ( com/pdftron.server/ )
at com.pdftron.server.Util.makeThumb ( com/pdftron.server/ )
at com.pdftron.server.DocReference.generateThumbUnsafe ( com/pdftron.server/ )
at com.pdftron.server.DocManagement$DocFetchTask.doThumb ( com/pdftron.server/ )
at com.pdftron.server.DocManagement$ ( com/pdftron.server/ )
at java.util.concurrent.ThreadPoolExecutor.runWorker ( java/util.concurrent/ )
at java.util.concurrent.ThreadPoolExecutor$ ( java/util.concurrent/ )
at ( java/lang/ )
Caused by: com.pdftron.server.HeartbeatException

at ( )
at ( )
at ( )

Here is a snippet of my Cloud Run YAML so you see the memory allocations:

      containerConcurrency: 80
      timeoutSeconds: 300
      serviceAccountName: [redacted]
      - name: wvserver-1
        image: [redacted]/wvserver:2.2.2
        - name: http1
          containerPort: 8090
        - name: TRN_PDFNET_KEY
          value: [redacted]
        - name: INCLUDE_DEMO
          value: 'false'
            cpu: 4000m
            memory: 2Gi
          timeoutSeconds: 240
          periodSeconds: 240
          failureThreshold: 1
            port: 8090

Please provide a link to a minimal sample where the issue is reproducible:

+1 on that one. We see the same exception from time to time running the same version but in Kubernets on Azure.


“heartbeat: failed for job” usually means that when loading a specific file, there was an issue that cause a failure.

If you could provide the file that causes this issue, we can investigate further.

Best regards,

Hi Tyler,

I can provide the file, but I don’t think that’s the issue, as this seems to happen for any file that’s fetched after the server has been online for some time.

Do clients need to unsubscribe from using the server? Is there something else that would explain why the heartbeat calls would fail?

This seems to be indicative of an overall server failure as it is also experiencing other issues around the same time (WebViewer Server timeouts - #6 by kkim)