View web crawler events logs

edit

View web crawler events logs

edit

App Search stores its web crawler logs in Elasticsearch. Kibana provides two user interfaces to view these logs: Discover and Logs.

For a complete reference of all events, see Web crawler (beta) events logs reference.

View web crawler events logs in Discover

edit

To view crawler logs in Discover, you must first configure a Kibana index pattern. If no index patterns have been created, Kibana will automatically direct you to the appropriate page. Otherwise, navigate to Stack ManagementIndex Patterns via the left sidebar.

Crawler events are logged within the enterprise-search set of system indices, so Kibana will not recognize available data by default.

  1. Select Try to create an index pattern anyway at the bottom of the data panel.

    Kibana redirect when no index patterns exist.
  2. On the Create index pattern page, toggle the selection for Include system and hidden indices.

    Set the index pattern name to .ent-search-crawler-*-logs*, then continue on to settings configuration.

    Create Kibana index pattern.
  3. From settings, select @timestamp as the primary time field, and create the index pattern.
  4. Navigate back to the Discover UI, select your newly created index pattern, and you are ready to begin exploring your crawl events in detail!

You will likely want to set up some custom columns in Discover to more easily discern crawl events at a glance.

To add a new column, select an entry from the list of available fields on the left sidebar. Handy columns for crawler events include crawler.crawl.id, url.domain, url.path, event.action, and http.response.status_code.

View web crawler events logs in Logs

edit

To view crawler logs in Logs, you must first configure a source configuration.

  1. Navigate to Logs UI via the left sidebar, under Observability.
  2. Select Change source configuration.
  3. Provide a name such as "Crawl Events" for this log source, and specify .ent-search-crawler-*-logs* as the index pattern.
  4. Configure any desired custom columns. A nice place to start is by removing the preset event.dataset and message options and adding crawler.crawl.id, url.domain,url.path, event.action, and http.response.status_code.

    Autocomplete will be available on these columns after the initial source configuration has been applied. You can edit these settings at any time.

  5. Apply the configuration, navigate to Stream, and you are ready to begin exploring your crawl events in detail!