Difference between revisions of "Metrics requirements"

From Archivematica
Jump to navigation Jump to search
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
[[Documentation]] > [[Requirements]] > Metrics requirements
 
[[Documentation]] > [[Requirements]] > Metrics requirements
  
 +
<div style="padding: 10px 10px; border: 1px solid black; background-color: #F79086;">This page is no longer being maintained and may contain inaccurate information. Please see the [https://www.archivematica.org/docs/latest/ Archivematica documentation] for up-to-date information.</div><p>
 +
 +
[[Category:Feature requirements]]
  
 
== Description ==
 
== Description ==
Line 16: Line 19:
 
== Use Cases ==
 
== Use Cases ==
  
* Output reports on:
+
The following are some use cases generated by the Archivematica team and contributed by Archivematica users.
  
number of file format X ingested per month
+
* Output reports on the following:
total disk size of ingests added per year
+
 
number of failed normalizations per format x
+
# number of file format X ingested per month
name of person who processed an AIP
+
# total disk size of ingests added per year
 +
# number of failed normalizations per format x
 +
# name of person who processed an AIP
 +
# inventory of shares & mount points (e.g. SIP Source, /var/archivematica, AIP Destination, DIP destination) including disk space (total, available, used & quota) and availability
 +
# total count of file formats
 +
# total disk usage per file format
 +
# growth: monthly report showing growth by file size, file format. Could also tap into descriptive metadata to show "collection growth"
 +
# AIP Monitoring: Bit errors detected, bit errors corrected
 +
# AIP average, median & max directory depth and directory breadth
 +
# File size distribution, file size distribution per format
 +
# Preservation and access normalization monitoring: Display not just file format but also version/specification
  
 
== Mockups ==
 
== Mockups ==
Line 33: Line 46:
  
 
For AIPs:
 
For AIPs:
-AIP name - In METS structMap: <div TYPE="directory" LABEL="[AIPname]-[UUID]">
+
* AIP name - In METS structMap: <div TYPE="directory" LABEL="[AIPname]-[UUID]">
-AIP UUID - In METS structMap: <div TYPE="directory" LABEL="[AIPname]-[UUID]">
+
* AIP UUID - In METS structMap: <div TYPE="directory" LABEL="[AIPname]-[UUID]">
-AIP storage location - Not in METS file
+
* AIP storage location - Not in METS file
-Date placed in storage - Not in METS file
+
* Date placed in storage - Not in METS file
-Date updated (when we have AIP versioning) - will be in METS header <metsHdr CREATEDATE="2013-05-09T15:00:00" LASTMODDATE=”2014-02-09T21:00:00>
+
* Date updated (when we have AIP versioning) - will be in METS header <metsHdr CREATEDATE="2013-05-09T15:00:00" LASTMODDATE=”2014-02-09T21:00:00>
-AIP size - Not in METS file
+
* AIP size - Not in METS file
-Related DIP - Not in METS file
+
* Related DIP - Not in METS file
-DIP storage location - Not in METS file
+
* DIP storage location - Not in METS file
-DIP size - Not in METS file
+
* DIP size - Not in METS file
-Date DIP uploaded - Not in METS file
+
* Date DIP uploaded - Not in METS file
  
 
For transfer backups:
 
For transfer backups:
-Transfer name <div TYPE="directory" LABEL="[Transfername]-[UUID]">
+
* Transfer name <div TYPE="directory" LABEL="[Transfername]-[UUID]">
-Transfer UUID <div TYPE="directory" LABEL="[Transfername]-[UUID]">
+
* Transfer UUID <div TYPE="directory" LABEL="[Transfername]-[UUID]">
-Transfer size - Not in METS file
+
* Transfer size - Not in METS file
-Transfer storage location - Not in METS file
+
* Transfer storage location - Not in METS file
-Date placed in storage - Not in METS file
+
* Date placed in storage - Not in METS file
 
 
== Workflow ==
 
 
 
== GUI ==
 
 
 
== API ==
 
 
 
 
 
 
 
 
 
 
 
[[Category:Development documentation]]
 

Latest revision as of 16:26, 11 February 2020

Documentation > Requirements > Metrics requirements

This page is no longer being maintained and may contain inaccurate information. Please see the Archivematica documentation for up-to-date information.

Description[edit]

  • The Archivematica team is currently gathering metrics requirements to support digital repository management. The question we would like to answer is: what kinds of metrics would be useful to Archivematica users (e.g. performance/usage statistics, AIP/DIP monitoring, file format statistics, etc.).
  • Our goal is to get a sense of the foundational elements necessary to fulfill future reporting requirements that we will need to build into Archivematica ... eventually. We are of course limited by available funding and time. We will prioritize the metrics and do our best to get as much as we can into upcoming releases given available funding and time.

Requirements[edit]

Use Cases[edit]

The following are some use cases generated by the Archivematica team and contributed by Archivematica users.

  • Output reports on the following:
  1. number of file format X ingested per month
  2. total disk size of ingests added per year
  3. number of failed normalizations per format x
  4. name of person who processed an AIP
  5. inventory of shares & mount points (e.g. SIP Source, /var/archivematica, AIP Destination, DIP destination) including disk space (total, available, used & quota) and availability
  6. total count of file formats
  7. total disk usage per file format
  8. growth: monthly report showing growth by file size, file format. Could also tap into descriptive metadata to show "collection growth"
  9. AIP Monitoring: Bit errors detected, bit errors corrected
  10. AIP average, median & max directory depth and directory breadth
  11. File size distribution, file size distribution per format
  12. Preservation and access normalization monitoring: Display not just file format but also version/specification

Mockups[edit]

Data Model[edit]

-Logged-in user (should be captured as PREMIS agent) -UUID of the Archivematica instance (should be captured as PREMIS agent) -Possibly also environment data: what machines did Archivematica live on, what versions of all the tools were installed (already in PREMIS events), what version of Archivematica was used (already in software agent).

For AIPs:

  • AIP name - In METS structMap:
  • AIP UUID - In METS structMap:
  • AIP storage location - Not in METS file
  • Date placed in storage - Not in METS file
  • Date updated (when we have AIP versioning) - will be in METS header <metsHdr CREATEDATE="2013-05-09T15:00:00" LASTMODDATE=”2014-02-09T21:00:00>
  • AIP size - Not in METS file
  • Related DIP - Not in METS file
  • DIP storage location - Not in METS file
  • DIP size - Not in METS file
  • Date DIP uploaded - Not in METS file

For transfer backups:

  • Transfer name
  • Transfer UUID
  • Transfer size - Not in METS file
  • Transfer storage location - Not in METS file
  • Date placed in storage - Not in METS file