Choose your language

Choose your login

Contact us

How To Collect PaperCut Pocket and PaperCut Hive Logs

THE PAGE APPLIES TO:

When troubleshooting, PaperCut support will probably request details like your organization ID, and the ID for any troublesome print job or scan.

We may also request that logs are collected from the end user’s workstations. This article includes a list of all the different types of log files and where to find them in case these need to be collected for troubleshooting.

How to find your Organization ID

The easiest way to get the Org ID is by logging into the PaperCut Pocket/Hive Admin console, click your email address at the top right corner and select Billing and Subscription as shown in the screenshot below.

Alternatively, you can collect the Org ID from the URL that’s covered below as well.

How to find a Printer ID

You can grab the following information from your PaperCut Pocket Administrator Portal by going to Printers and clicking on the Printer in question.

How to find a Print Job ID or Scan Job ID

If it is a print job or a scan job, then knowing Job ID/Scan ID is essential. You’ll be able to get this information from the PaperCut Pocket / Hive admin console, select the Job Log tab and click on the problematic print or scan job. The Job ID/Scan ID can be found in the URL or at the bottom of the page as shown in the screenshots:

How to enable diagnostics mode

In the PaperCut Pocket / Hive admin console, click your email address at the top right corner and select Settings.

Scroll down to the bottom of the page and toggle Diagnostics mode.

What does the diagnostics mode in the Papercut Pocket / Hive admin console do?

You can view detailed logging of your print job. You can view this by going to the Job Log tab and select your print job as shown below.

Click the Diagnostics button.

When you enable diagnostics mode, it adds extra Edge Node actions in the admin console. Like restart and update for the Edge Nodes under the Edge Mesh tab as shown below.

Pocket & Hive Client Setup Logs

These are created when the Pocket or Hive Client installer is run.

Windows:

Look for a file named Setup Log <date_stamp> in the user’s %TEMP% directory.

Edge Node Logs

Windows:

PaperCut Pocket: C:\Program files\PaperCut Pocket\data\logs - Installation and day to day logs with rolling policy every 50 MB

PaperCut Hive: C:\Program files\PaperCut Hive\data\logs - Installation and day to day logs with rolling policy every 50 MB

macOS:

PaperCut Pocket: /Library/PaperCut Pocket/data/logs - Installation and day to day logs with rolling policy every 50 MB

PaperCut Hive: /Library/PaperCut Hive/data/logs - Installation and day to day logs with rolling policy every 50 MB

PaperCut Printer Client Logs

Windows:

PaperCut Pocket: %localappdata%\Programs\PaperCut Pocket\data\logs - Installation and day to day logs with rolling policy every 50 MB

PaperCut Hive: %localappdata%\Programs\PaperCut Hive\data\logs - Installation and day to day logs with rolling policy every 50 MB

macOS:

PaperCut Pocket: ~/Library/PaperCut Pocket/data/logs - Installation and day to day logs with rolling policy every 50 MB

PaperCut Hive: ~/Library/PaperCut Hive/data/logs - Installation and day to day logs with rolling policy every 50 MB

Note: For macOS, since the print client is installed under the user context you’ll need to perform either the below steps to grab these set of logs:

  1. Open Finder.

  2. Hold down the Option key when clicking the Go menu.

  3. Library will appear below the current user’s home directory

Or

  1. Open Finder.

  2. Click on the Go menu and choose Go to Folder.

  3. In the Go To Folder dialog box, type ~/Library

  4. Click Go

Chrome:

  1. Open the Extensions menu in Chrome by going to chrome://extensions in the address bar.
  2. Check the box for “Developer Mode”
  3. Under the PaperCut Pocket/ Hive extension enable the “Collect errors” option then replicate the issue. Following this, click “background page”.

Note 💡 If you can’t find this section, you may be in a managed environment where this is disabled. If you’re the admin, go to the Google Chrome Enterprise admin page and navigate to Device Management > Chrome > Settings and set the value of Developer Tools to Always allow use of built-in developer tools .

  1. In the new Developer Tools window, click on the “Console tab.
  2. Click on the Ø symbol to clear any unrelated log files before beginning.
  3. Now try to reproduce the problem at this point. (If the issue is printer discovery then click on the ⋮ symbol in Chrome, choose Print, and then Change to force printer discovery.)
  4. Then back in the Developer Tools window, right click on any white space and choose “Save as…”
  5. This new log file should be saved to your Downloads folder, please send it to PaperCut support.

Direct Print tracking logs

Windows:

PaperCut Pocket: C:\Program files\PaperCut Pocket\data\logs\print-provider.log - Installation and day to day logs with rolling policy every 50 MB

PaperCut Hive: C:\Program files\PaperCut Hive\data\logs\print-provider.log - Installation and day to day logs with rolling policy every 50 MB

macOS:

PaperCut Pocket: Copies the file to your desktop sudo cp /Library/PaperCut\ Hive/data/logs/print-provider.log ~/Desktop - Installation and day to day logs with rolling policy every 50 MB

PaperCut Hive: Copies the file to your desktop sudo cp /Library/PaperCut\ Hive/data/logs/print-provider.log ~/Desktop - Installation and day to day logs with rolling policy every 50 MB

How to collect logs for the Lite Release App

  1. Log onto the PaperCut Hive admin interface, select Printers, select the printer > Apps.

  2. Follow the steps and run the installation command.

  3. If it fails, re-run the command and add -pclog.dev flag at the end of it and send us the console output. This will give us extra logging to work out what’s going on.

For more information about PaperCut Pocket and Hive, check out the PaperCut Pocket and Hive Help Center.

Device Logs

For some brands of copier there is an additional level of logging that we call “Deep Logging”. Information on how to enable that can be found in our article How to enable/download embedded deep logs with PaperCut Hive.


Categories: PaperCut Pocket and Hive KB Articles , Pocket & Hive Troubleshooting Articles


Keywords: Pocket , Hive , Logs

Comments

Last updated March 15, 2024