Skip to main content

How to Use Logging

Logging: Monitor and Review Transactions at Travelgate​

Travelgate’s Logging feature offers a powerful way to track and analyze transaction logs. Whether you need to review Booking Flow transactions or identify error codes, Logging provides access to critical data for troubleshooting and performance monitoring.

This guide will walk you through how to use Logging, the information it provides, and how to refine your search using filters. It also covers specific cases, such as retrieving One Step Book operation logs and important details for Legacy Pull Buyers API users.

By leveraging Logging, you can gain valuable insights into your connection activity, improve performance, and quickly resolve issues. Let’s dive in!

How Can I Use Logging?​

  1. Log into our Platform.
  2. Navigate to Monitoring (in the top menu) and select Logging.
  3. Choose your search method: You can search by connection, reference, or session ID.
  4. Apply filters to refine your search:
    • Time range: Up to 2 months.
    • Access: Filter by Hotel-X Access (by Name or Code). This filter applies only to Hotel-X connections.
    • Operation type: Search, Quote, Book, Cancel, Other (Booking List/Booking Read).
      • Note: The "Search" operation type will only return results if searches have been audited first.
    • Status/Error code: Select specific errors to filter results.
  5. Click on "Search logs" to retrieve the logs.
info
  • Buyer connections using our Legacy API are audited at the connection level — access-level auditing is not available. This means that when retrieving logs using the Logging tool, you should not use the Access Filter, as it will return no results.
  • If you're a Seller, you can check whether your Buyer is integrated via the Hotel-X API or the Legacy Pull Buyers API by looking for the “Hotel-X” label on the connection in the “My Connections” screen. If the Buyer is using the Hotel-X API, the “Hotel-X” label will appear next to the “Buyer” label.

logging_new_1

What Information Does Logging Provide?​

When your search returns logs, Logging will display the following details:

  • Timestamp (date and time of the transaction)
  • Transaction duration (at the integration level)
  • Connection
  • Client
  • Access
  • Status/Error Code
  • Operation type (Search, Quote, Book, Cancel, Other)
  • Session ID (unique identifier for the transaction)
  • Traffic Type (Basic, Optimized, Scheduler, Speed)
  • Actions: Logs available for download include Hotel-X Logs/Legacy Logs, and Connector Logs. For Book transactions, you can directly download the corresponding Quote logs used in that specific booking flow. Additionally, you can download all visible logs on your screen by clicking the 'Download All' button above the table.

logging_new_2

If your search returns a large number of results, use additional filters on the right to refine your search:

  • Filter by Client/Supplier
  • Filter by Access
  • Filter by Duration

logging_new_3

Reservation Status vs. Transaction Status

The "Status/Error Code" displayed in the Logging screen only shows whether the transaction was processed without errors—it does not reflect the actual status of a reservation. For example, a reservation may appear as OK in the Logging screen, even if its actual Book status is UNKNOWN, as long as the transaction completed without errors.

To determine the actual status of a reservation, you should perform a Booking Read operation.

Can I download my Hotel-X logs through Logging?​

Yes, you can retrieve Hotel-X logs directly by selecting 'Hotel-X Logs' under the Download options.

What is the difference between Hotel-X Logs, Legacy Logs, and Connector Logs?​

In the Actions section, you can download different types of transaction logs:

  • Hotel-X Logs: Transactions made by Buyers through our Hotel-X API.
  • Legacy Logs: Transactions made by Buyers through our Legacy API.
  • Connector Logs: Transactions made through our integration when directly interacting with the Seller’s API.

Connector Logs are always available, as they capture all activity between our integration and the Seller. However, you’ll see either Hotel-X Logs or Legacy Logs—never both—depending on which API the Buyer is using.

Can I Retrieve Logs from a One Step Book Operation?​

Yes, you can obtain Quote and Book logs for the One Step Book operation using Logging. Simply apply the appropriate filters (connection, reference, or session ID) to locate the relevant logs.

Why can’t I find my logs in the Logging App?​

If you can’t find the logs you need in the Logging App, try the following:

  • For booking or cancellation error logs:
    Always search using the “Search by Connections” → “Time Range” filter and, if possible, filter by Error. Logs for failed bookings or cancellations cannot be retrieved by client reference, supplier reference, or session ID.
  • Reference filter for OK logs:
    The search-by-reference filter won’t return results until the day after the booking is made. To find logs before then—or if the reference search doesn’t return results—use the 'Time Range' filter instead.

When to Use the Access Filter​

Do not use the Access Filter for Legacy Connections—it only returns results for Hotel-X Connections. If you apply it to a Legacy Connection, it will return no results even if transactions exist for that time frame.

To check whether a Buyer is connected via Legacy or Hotel-X:

  1. Go to Connections → My Connections.
  2. Filter by Buyer (Buyer card).
  3. Look at the Buyer Card to the right of the Buyer name and code.
  • If the Hotel-X label appears, the Buyer uses the Hotel-X API.
  • If no Hotel-X label appears, the Buyer uses the Legacy API, and the Access filter will not return results and you should use the 'Time Range' filter instead.

Some Buyers may be transitioning from Legacy to Hotel-X. If you’re unsure, contact the Buyer for confirmation.

Legacy Pull Buyers API Information

For Buyer connections through our Legacy Pull Buyers API, filtering by Hotel-X Access Code is not available. Instead, connections are identified through the Buyer's clientname#suppliercode relationship.

Some Buyers may be transitioning from the Legacy Pull Buyers API to the Hotel-X API, meaning they could have traffic on both APIs. If you're unsure, we strongly recommend reaching out to your Buyers for further details.