Current Release

This documentation covers the current version of Fedora. Looking for another version? See all documentation.

Overview

Fedora provides an endpoint for users wishing to get some basic statistics for their repository, these are storage statistics and **not** usage metrics.

Currently this endpoint only provides the following three reports. Further report development will depend on community use cases.

RESTful API

High Level Stats Summary


Request URI: /fcr:stats

Methods: GET


GET Retrieve summary level repository statistics including:

  • resource count, 
  • binary resource count,
  • binary resource bytes
  • binary resource count by mimetype
  • binary resource bytes by mimetype

Request Headers:

N/A

Request Parameters :

Example:

curl http://localhost:8080/rest/fcr:stats

Response:

{
  "resource_count": 2,
  "binaries": {
    "mime_types": [
      {
        "resource_count": 1,
        "byte_count": 31536,
        "mime_type": "application/pdf"
      }
    ],
    "resource_count": 1,
    "byte_count": 31536
  },
  "all_resources": {
    "rdf_types": [
      {
        "resource_count": 1,
        "byte_count": 31536,
        "resource_type": "http://fedora.info/definitions/v4/repository#Binary"
      },
      {
        "resource_count": 1,
        "byte_count": 0,
        "resource_type": "http://fedora.info/definitions/v4/repository#Container"
      },
      {
        "resource_count": 2,
        "byte_count": 31536,
        "resource_type": "http://fedora.info/definitions/v4/repository#Resource"
      },
      {
        "resource_count": 2,
        "byte_count": 31536,
        "resource_type": "http://mementoweb.org/ns#OriginalResource"
      },
      {
        "resource_count": 2,
        "byte_count": 31536,
        "resource_type": "http://mementoweb.org/ns#TimeGate"
      },
      {
        "resource_count": 1,
        "byte_count": 0,
        "resource_type": "http://www.w3.org/ns/ldp#BasicContainer"
      },
      {
        "resource_count": 1,
        "byte_count": 0,
        "resource_type": "http://www.w3.org/ns/ldp#Container"
      },
      {
        "resource_count": 1,
        "byte_count": 31536,
        "resource_type": "http://www.w3.org/ns/ldp#NonRDFSource"
      },
      {
        "resource_count": 1,
        "byte_count": 0,
        "resource_type": "http://www.w3.org/ns/ldp#RDFSource"
      },
      {
        "resource_count": 2,
        "byte_count": 31536,
        "resource_type": "http://www.w3.org/ns/ldp#Resource"
      }
    ]
  }
} 

Status:

200


High Level Stats Summary


Request URI: /fcr:stats/binaries

Methods: GET


GET Retrieve summary level repository statistics including:

Request Headers:

N/A

Request Parameters :

Example:

curl http://localhost:8080/rest/fcr:stats/binaries

Response:

{
  "mime_types": [
    {
      "resource_count": 1,
      "byte_count": 31536,
      "mime_type": "application/pdf"
    }
  ],
  "resource_count": 1,
  "byte_count": 31536
} 

Status:

200

High Level Stats Summary


Request URI: /fcr:stats/rdf-types

Methods: GET


GET Retrieve summary level repository statistics including:

Request Headers:

N/A

Request Parameters :

Example:

curl http://localhost:8080/rest/fcr:stats/rdf-types

Response:

{
  "rdf_types": [
    {
      "resource_count": 1,
      "byte_count": 31536,
      "resource_type": "http://fedora.info/definitions/v4/repository#Binary"
    },
    {
      "resource_count": 1,
      "byte_count": 0,
      "resource_type": "http://fedora.info/definitions/v4/repository#Container"
    },
    {
      "resource_count": 2,
      "byte_count": 31536,
      "resource_type": "http://fedora.info/definitions/v4/repository#Resource"
    },
    {
      "resource_count": 2,
      "byte_count": 31536,
      "resource_type": "http://mementoweb.org/ns#OriginalResource"
    },
    {
      "resource_count": 2,
      "byte_count": 31536,
      "resource_type": "http://mementoweb.org/ns#TimeGate"
    },
    {
      "resource_count": 1,
      "byte_count": 0,
      "resource_type": "http://www.w3.org/ns/ldp#BasicContainer"
    },
    {
      "resource_count": 1,
      "byte_count": 0,
      "resource_type": "http://www.w3.org/ns/ldp#Container"
    },
    {
      "resource_count": 1,
      "byte_count": 31536,
      "resource_type": "http://www.w3.org/ns/ldp#NonRDFSource"
    },
    {
      "resource_count": 1,
      "byte_count": 0,
      "resource_type": "http://www.w3.org/ns/ldp#RDFSource"
    },
    {
      "resource_count": 2,
      "byte_count": 31536,
      "resource_type": "http://www.w3.org/ns/ldp#Resource"
    }
  ]
}

Status:

200