Export IT Analytics Data

The platform collects a wide variety of real-time information about your site that can be useful for IT analytics. The Kibo eCommerce Import-Export Application (2.0) exports this information - including error incidents, performance metrics, and unavailable links - to a bucket in an Amazon Simple Storage Service (S3) account or to an FTP or FTPS server. Only Secure FTP is supported.

The log files that the import/export tool returns show all inbound requests to Kibo eCommerce that use our public API. These calls can come from users or connector applications, and the data returned is unrestricted, so there is no cap on the amount of data you can retrieve. The log files themselves are primarily in W3C Extended log file format (IIS 6.0), but include some additional Kibo eCommerce information to help you troubleshoot errors. Descriptions of the log file fields and answers to some frequently asked questions appear at the end of this topic.

Contact Kibo Support to request installation of the Kibo eCommerce Import-Export Application on your tenant.

App Features

  • Collect real-time information about your site(s) that helps you monitor errors, warnings, performance metrics, unavailable links, and uptime issues.
  • Export logged data to your Amazon S3 account for storage and analysis.
  • Export logged data to a Secure FTP server of your choice.
  • Automate data exports to send updated logs at specified time intervals.

Configuration Requirements

  • The Kibo eCommerce Import-Export Application must be installed on your tenant.
  • You must have an Amazon S3 account or access to an FTP server on a public domain.

Where do you want to log your data?

You can configure both export locations if desired, but you can only export data to one destination type at a time.

Configure Export to an Amazon S3 Account

Create a Bucket in Your S3 Account

The Kibo eCommerce Import-Export Application requires a bucket in your S3 account for the log files. The application recognizes any existing buckets, but you might want to create a unique one just for your Kibo eCommerce data.

  1. Log in to Amazon Web Services.
  2. Create a bucket for your log files.

You can refer to the Amazon Web Services help for a walkthrough of creating a bucket.

Obtain Amazon S3 Security Credentials

The Kibo eCommerce Import-Export Application requires an Amazon S3 Access Key ID, Secret Access Key, and active Security Token Service Region:

  1. Log in to Amazon Web Services.
  2. Navigate to the Security Credentials page under your account drop-down.
    Amazon Web Services navigation menu with a callout for Security Credentials
  3. In the left nav, select Users.
  4. Click Create New Users, and add a user with a name you will recognize. For example: Mozu_Imp_Exp
    Ensure that the Generate an access key for each user option is selected.
  5. Click Create.
  6. Copy the Access Key ID and Secret Access Key. You will use these in the next section.
    Access Keys section with an example Key ID

    Save your Access Key ID and Secret Access Key in a secure location. You cannot view your Secret Access Key again after you create it, so if you lose it, you will have to generate a new one.

  7. In the entry for the new user, go to the Permissions tab.
  8. Click Attach Policy, and select Amazon S3 Full Access.
  9. Navigate to the Account Settings page.
  10. Under Security Token Service Regions, note your active regions.

    Security Token Service Regions section with example active regions

Enable Your S3 Account in Kibo eCommerce

  1. In Admin, go to System > Customization > Applications.
  2. Click Mozu Import-Export Application (version 2.0.0).
  3. Click the Configuration link to open configuration settings.
  4. On the Storage Options tab, select Enable S3 Account and enter the account info you copied in the previous section.
    Storage Options configurations in the Import/Export application settings
  5. Click Save.

Configure Export to a Secure FTP Server

You can export log files to any Secure FTP server that is available on a public domain. The FTP server must be on a public domain for Kibo eCommerce to be able to access the server and write files to it.

Obtain FTP Server Credentials

If you want to export logs to an FTP server, note the following details about your FTP setup:

  • Server name
  • Username
  • Password
  • Whether the server uses Secure FTP
  • Port number
  • A directory on the server in which to store the logs of exported data

If you need help obtaining these details, contact your IT department or FTP administrator.

Configure the Kibo eCommerce Import-Export Settings

  1. In Admin, go to System > Customization > Applications.
  2. Click Mozu Import-Export Application (version 2.0.0).
  3. Click the Configuration link to open configuration settings.
  4. On the Storage Options tab, select Enable FTP and enter the information for your FTP server.
    Storage Options settings with a callout for the Enable FTP toggle
  5. Click Save.

Enable the App

You do not need to enable the app to export IT analytics information. Enabling this app turns on import/export functionality for customers, orders, and coupons and coupon sets.

Schedule an Export

Use the configuration page of the Kibo eCommerce Import-Export Application to schedule exports of IT data about your site. You can also view your export history.

  1. In Admin, go to System > Customization > Applications.
  2. Click Mozu Import-Export Application (version 2.0.0).
  3. Click the Configuration link to open the configuration settings.
  4. On the Web Logs tab, select Settings.
  5. Use the External Storage drop-down to select the type of export destination. You cannot export data to both an S3 and an FTP destination simultaneously. If you want to switch between destinations, you must stop an export and configure a new one.
  6. Using the Export Interval (minutes) drop-down, choose how frequently to export data.
  7. (Amazon S3) Using the S3 Bucket drop-down, choose an Amazon S3 bucket to receive the logs in.
  8. (FTP) In FTP Directory, enter the directory on the FTP server, preceded by a "/", to receive the logs.
    Close-up of the external storage and FTP directory settings
  9. Click Save.

If you want to change these settings after configuring an export, stop the export first and then make the changes.

View Logs and Export History

To view full log information, access your Amazon S3 account or FTP server and open the logs.

To check what exports the Kibo eCommerce Import-Export Application has generated, use the Web Logs page to view a history of exported logs. You can review the date and time of a log and verify whether the export completed successfully or not. If you want to view additional information about an export, click View in the appropriate row.

Example export history table

Stop an Export

You can stop an export at any time:

  1. Open the Web Logs page.
  2. Click Stop Export.

Log File Content

The exported log files contain raw data primarily in the W3C Extended log file format (IIS 6.0). Log files are specific to the tenant on which the application is installed and data is exported. Each file contains the following data:

ColumnFull Field NameDescription
dateDateThe date on which the log entry was recorded.
timeTimeThe time, in UTC, at which the log entry was recorded.
s_ipServer IP AddressThe IP address of the server that received the request.
cs_methodMethodThe type of request. For example: GET.
cs_uri_stemURI StemThe URI for the target of the request. This can be any page or file that exists on your tenant.
cs_uri_queryURI QueryThe Universal Resource Identifier (URI) query that the client was trying to perform. If no URI query was made, this column is empty.
s_portServer PortThe number of the server port that is configured for the service.
cs_usernameUser NameThe authenticated username of the user that tried to access your server. If the user is anonymous, this column contains a hyphen (-).
c_ipClient IP AddressThe IP address of the client that initiated the request.
cs(User Agent)User AgentInformation about the browser that the client used.
cs(Referer)ReferrerThe site that referred the client to your site. If no referrer is identified, this column is empty.
sc_statusHTTP StatusThe HTTP status code returned by the server.
sc_substatusProtocol SubstatusThe substatus code returned with the sc_status code.
sc_win32_statusWin32 StatusThe Windows status code.
time_takenTime TakenThe amount of time that the action took to complete, in milliseconds.
x_siteidMozu Site IDThe site ID for the Kibo eCommerce site that received the request.
x_corlidMozu Correlation IDThe Kibo eCommerce correlation ID (32 character GUID), which is the unique identifier for the API request.
x_useridMozu User IDThe Kibo eCommerce user ID (32 character GUID) of the user who made the request.
x_visitMozu VisitThe Kibo eCommerce visit ID (32 character GUID), which is the unique identifier for the specific customer visit that initiated the request.


The following are some frequently asked questions about the log files you can export for your tenant:

Q: What calls appear in my log file?

A: The log files contain all inbound calls to Kibo eCommerce that use our public API. They do not contain any outbound calls.

Q: Can I get information about calls from connector apps or integrations?

A: If the application is making calls to Kibo eCommerce using our public API, those calls will appear in the logs. For security reasons, we do not display any outbound calls Kibo eCommerce makes to third-parties through connector apps.

Q: Can I get historical data for my tenant?

A: The import/export app returns all data for your tenant starting from the time you configure the app. You cannot retroactively access historical data. However, if at some point you disable these exports and then re-enable them, we will return any historical data available for the time that exports were disabled. Kibo eCommerce retains log files for 30 days, after which time they are discarded.

Q: Can I aggregate log data from multiple production tenants?

A: Each log file is specific to the tenant on which it was generated. Any aggregation must be completed in post-processing. Kibo eCommerce cannot aggregate files across multiple tenants.

Q: Can I restrict the amount of logged data I receive?

A: The import/export app always returns all logged data. You can stop exports entirely or adjust the Export interval to manipulate the size of the log files, but you cannot restrict the data you receive.