Review crawl history and analytics for an external content connector

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 3 min. de leitura

    • View crawl history records and analytics for an external content connector. Drill into a crawl history record to see statistics and errors metrics and alerts for the crawl in question.

    Antes de Iniciar

    Role required: ais_adminsn_ext_conn.xcc_admin

    Por Que e Quando Desempenhar Esta Tarefa

    The crawl history page for an external content connector shows crawl history records for individual crawls, along with analytics summarizing crawl results from the last 30 days and the connector's total count of external documents fed to AI Search for indexing.

    The crawl history page for an external content connector shows a crawl history record for each crawl run by the connector.

    You can select an individual crawl history record to examine a crawl in more detail, viewing counts of items found, discovered, and updated as well as performance data and a list of any errors alerts encountered during the crawl. Additionally, you can view crawl-related messages in the system log or cancel a crawl that's currently running.

    Procedimento

    1. Navigate to All > External Content Connectors > External Content Admin Home.
    2. In the Connectors list, select the record for the external content connector that you want to review crawl history and analytics for.
    3. In the connector editor, select the Crawl history tab.
      The Crawl history section shows a record for each crawl run for the connector in the last 30 days. The Analytics section summarizes crawl results from the last 30 days and shows the total count of external documents fed to AI Search for indexing.
    4. Opcional: To view more detailed metrics and error alert messages for a specific crawl, select the crawl history record for that crawl.

      On the Crawl details page, the About this crawl header section reports the crawl's status, its scope (full or partial), its cadence (whether it was scheduled or a one-time crawl), its start and end times and duration, and the ID of the user who started it. For a partial crawl, this section also shows a link with the label of the chosen start point. Selecting this link displays the record for the start point, showing its ID as well as its label.

      The Statistics tab shows details about items encountered during the crawl.
    5. Opcional: To view entries for any alerts encountered during the crawl, navigate to the Alerts tab.

      Alerts include informational, debugging, warning, and error events logged by the connector during its crawl.

      Each alert entry includes a type and a scope. The alert type indicates the importance of the recorded event, as follows.
      Debugging
      A debugging alert provides detailed insights into the connector's behavior during a crawl.
      Informational
      An informational alert indicates the successful operation of connector functionality during a crawl.
      Warning
      A warning alert indicates that the connector encountered an unusual behavior or potentially problematic issue during a crawl.
      Error
      An error alert indicates that the connector encountered a problem that disrupted its functionality during a crawl.
      The alert scope indicates what the recorded event affected.
      Single
      The event affected a single content item retrieved by the connector crawl.
      Multiple
      The event affected multiple content items retrieved by the connector crawl.
      All
      The event affected all content items retrieved by the connector crawl.
      Crawl
      The event affected the crawl job for the connector crawl.
    6. To view details for an alert, select the View Details link for that alert entry.
    7. Opcional: To cancel a running crawl, select Cancel on the Crawl details page, then select Yes, cancel in the Cancel crawl dialog box.
      Nota:
      Canceling a crawl may take a minute or two. During this time, the connector may continue to retrieve searchable content and security principals and feed them to AI Search.
    8. Opcional: To view messages from the crawl in the system log, select View logs on the Crawl details page.
      For more information on using the system log to review messages and diagnose issues, see System log.
      The system log opens, with a filter applied to show only messages from the selected crawl.