Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


The metrics API provides various metrics information

Easy Heading Free
navigationTitleOn this Page
navigationExpandOptionexpand-all-by-default

Section

Crawl metrics

Creates basic crawl metrics report from the audit index. This endpoint needs the ADMINISTRATOR  role to be executed.

Panel
borderColorblack
bgColor#fafafb

GET /aspire/_api/metrics/:seedId/:crawlId

Path and Request Body Parameters

NameTypeRequiredDescription
seedIdstringRequiredThe seed id
crawlIdstringRequired

The crawl id

Response

Code Block
languagejs
themeRDark
{
    "crawl-metrics": {
        "seedId": "0dda9332-ca52-44e1-ba63-95e51b46f951",
        "crawlId": "1658154843524",
        "metrics": {
            "add": 3,
            "enqueued": 4,
            "crawlBegin": 1,
            "scanned": 1,
            "crawlEnd": 1,
            "scannedNotIndexed": 1,
            "controlItem": 4
        },
        "workerDistribution": [
            {
                "workerId": "worker_192.168.112.1:41443//AAABghGLnak=",
                "metrics": {
                    "add": 3,
                    "enqueued": 4,
                    "crawlBegin": 1,
                    "scanned": 1,
                    "crawlEnd": 1,
                    "scannedNotIndexed": 1,
                    "controlItem": 4
                }
            }
        ]
    }
}

Status: 200




Section

Jobs performance statistics

Creates jobs performance statistics report from the audit index. This endpoint needs the ADMINISTRATOR  role to be executed.

Panel
borderColorblack
bgColor#fafafb

POST /aspire/_api/metrics/getJobsStatistics


Query String Parameters

type
NameTypeRequiredDescription
sizenumberOptional

How many audit items should be viewed in the report. This does not affect the aggregation part of the report. (default = 0)

aggSourcestringOptionalThe audit item metrics parts to be aggregated. (default = root)
aggSortFieldstringOptionalRequired

The type of the batch

  • scan
  • process


    Path and Request Body Parameters

    NameTypeRequiredDescription
    idstringRequiredThe identifier(s) of the batch(es) to be acknowledged

    Examples

    Acknowledge a single batch

    Code Block
    languagejs
    themeRDark
    PUT /aspire/_api/manager/batch/ack/AAABcID5GBc=?type=scan
    
    PUT /aspire/_api/manager/batch/ack?type=scan
    {
      "id": ["AAABcID5GBc="]
    }

    Acknowledge multiple batches

    Code Block
    languagejs
    themeRDark
    PUT /aspire/_api/manager/batch/ack?type=scan
    {
      "id": ["AAABcID5GBc=", "AAABcIueWUc="]
    }

    Response

    Code Block
    languagejs
    themeRDark
    {
      "message": "optional response message"
    }

    Status: 200, 404