Äï45������ådocutils.nodesîådocumentîìî)Åî}î(å	rawsourceîå�îåchildrenî]îh�åsectionîìî)Åî}î(hhh]î(h�åtitleîìî)Åî}î(hå
Event Loggingîh]îh�åTextîìîå
Event LoggingîÖîÅî}î(hhåparentîhhhåsourceîNålineîNubaå
attributesî}î(åidsî]îåclassesî]îånamesî]îådupnamesî]îåbackrefsî]îuåtagnameîhhhhhhå_/var/lib/jenkins/jobs/metacat_beta/workspace/metacat/docs/user/metacat/source/event-logging.rstîhKubh�å	paragraphîìî)Åî}î(hXÖ��Metacat keeps an internal log of events (such as insertions, updates, deletes,
and reads) that can be accessed with the getlog action. Using the getlog action,
event reports can be output from Metacat in XML format, and/or customized to
include only certain events: events from a particular IP address, user, event
type, or that occurred after a specified start date or before an end date.îh]îhXÖ��Metacat keeps an internal log of events (such as insertions, updates, deletes,
and reads) that can be accessed with the getlog action. Using the getlog action,
event reports can be output from Metacat in XML format, and/or customized to
include only certain events: events from a particular IP address, user, event
type, or that occurred after a specified start date or before an end date.îÖîÅî}î(hh/hh-hhhNhNubah}î(h]îh!]îh#]îh%]îh']îuh)h+hh*hKhhhhubh,)Åî}î(håsThe following URL is used to return the basic log- an XML-formatted log of all
events since the log was initiated::îh]îhårThe following URL is used to return the basic log- an XML-formatted log of all
events since the log was initiated:îÖîÅî}î(hårThe following URL is used to return the basic log- an XML-formatted log of all
events since the log was initiated:îhh;hhhNhNubah}î(h]îh!]îh#]îh%]îh']îuh)h+hh*hK
hhhhubh�å
literal_blockîìî)Åî}î(hå6http://some.metacat.host/context/metacat?action=getlogîh]îhå6http://some.metacat.host/context/metacat?action=getlogîÖîÅî}î(hhhhLubah}î(h]îh!]îh#]îh%]îh']îå	xml:spaceîåpreserveîuh)hJhK
hhhhhh*ubh,)Åî}î(håªNote that you must be logged in to Metacat using the HTTP interface or you
will get an error message. For more information about logging in, please see
Logging In with the HTTP Interface.îh]îhåªNote that you must be logged in to Metacat using the HTTP interface or you
will get an error message. For more information about logging in, please see
Logging In with the HTTP Interface.îÖîÅî}î(hh^hh\hhhNhNubah}î(h]îh!]îh#]îh%]îh']îuh)h+hh*hKhhhhubhK)Åî}î(hX��<!-- Example of XML Log -->
<?xml version="1.0"?>
<log>
<logEntry><entryid>44</entryid><ipAddress>34.237.20.142</ipAddress><principal>uid=jones,
o=NCEAS,dc=ecoinformatics,dc=org</principal><docid>esa.2.1</docid><event>insert</event>
<dateLogged>2004-09-08 19:08:18.16</dateLogged></logEntry>
<logEntry><entryid>47</entryid><ipAddress>34.237.20.142</ipAddress><principal>uid=jones,o=NCEAS,
dc=ecoinformatics,dc=org</principal><docid>esa.3.1</docid><event>insert</event><dateLogged>2004-
09-14 19:50:40.61</dateLogged></logEntry>
</log>îh]îhX��<!-- Example of XML Log -->
<?xml version="1.0"?>
<log>
<logEntry><entryid>44</entryid><ipAddress>34.237.20.142</ipAddress><principal>uid=jones,
o=NCEAS,dc=ecoinformatics,dc=org</principal><docid>esa.2.1</docid><event>insert</event>
<dateLogged>2004-09-08 19:08:18.16</dateLogged></logEntry>
<logEntry><entryid>47</entryid><ipAddress>34.237.20.142</ipAddress><principal>uid=jones,o=NCEAS,
dc=ecoinformatics,dc=org</principal><docid>esa.3.1</docid><event>insert</event><dateLogged>2004-
09-14 19:50:40.61</dateLogged></logEntry>
</log>îÖîÅî}î(hhhhjubah}î(h]îh!]îh#]îh%]îh']îhZh[uh)hJhKhhhhhh*ubh,)Åî}î(hå´The basic log can be quite extensive. To subset the report, restrict the
matching events using parameters. Query parameters can be combined to further
restrict the report.îh]îhå´The basic log can be quite extensive. To subset the report, restrict the
matching events using parameters. Query parameters can be combined to further
restrict the report.îÖîÅî}î(hhzhhxhhhNhNubah}î(h]îh!]îh#]îh%]îh']îuh)h+hh*hK hhhhubh�åtableîìî)Åî}î(hhh]îh�åtgroupîìî)Åî}î(hhh]î(h�åcolspecîìî)Åî}î(hhh]îh}î(h]îh!]îh#]îh%]îh']îåcolwidthîKuh)hêhhçubhë)Åî}î(hhh]îh}î(h]îh!]îh#]îh%]îh']îåcolwidthîK5uh)hêhhçubh�åtheadîìî)Åî}î(hhh]îh�årowîìî)Åî}î(hhh]î(h�åentryîìî)Åî}î(hhh]îh,)Åî}î(hå	Parameterîh]îhå	ParameterîÖîÅî}î(hh∑hhµubah}î(h]îh!]îh#]îh%]îh']îuh)h+hh*hK%hh≤ubah}î(h]îh!]îh#]îh%]îh']îuh)h∞hh≠ubh±)Åî}î(hhh]îh,)Åî}î(håDescription and Valuesîh]îhåDescription and ValuesîÖîÅî}î(hhŒhhÃubah}î(h]îh!]îh#]îh%]îh']îuh)h+hh*hK%hh…ubah}î(h]îh!]îh#]îh%]îh']îuh)h∞hh≠ubeh}î(h]îh!]îh#]îh%]îh']îuh)h´hh®ubah}î(h]îh!]îh#]îh%]îh']îuh)h¶hhçubh�åtbodyîìî)Åî}î(hhh]î(h¨)Åî}î(hhh]î(h±)Åî}î(hhh]îh,)Åî}î(hå	ipAddressîh]îhå	ipAddressîÖîÅî}î(hh˘hh˜ubah}î(h]îh!]îh#]îh%]îh']îuh)h+hh*hK'hhÙubah}î(h]îh!]îh#]îh%]îh']îuh)h∞hhÒubh±)Åî}î(hhh]îh,)Åî}î(hå3Restrict the report to this IP Address (repeatable)îh]îhå3Restrict the report to this IP Address (repeatable)îÖîÅî}î(hj��hj��ubah}î(h]îh!]îh#]îh%]îh']îuh)h+hh*hK'hj��ubah}î(h]îh!]îh#]îh%]îh']îuh)h∞hhÒubeh}î(h]îh!]îh#]îh%]îh']îuh)h´hhÓubh¨)Åî}î(hhh]î(h±)Åî}î(hhh]îh,)Åî}î(hå	principalîh]îhå	principalîÖîÅî}î(hj0��hj.��ubah}î(h]îh!]îh#]îh%]îh']îuh)h+hh*hK)hj+��ubah}î(h]îh!]îh#]îh%]îh']îuh)h∞hj(��ubh±)Åî}î(hhh]îh,)Åî}î(hå-Restrict the report to this user (repeatable)îh]îhå-Restrict the report to this user (repeatable)îÖîÅî}î(hjG��hjE��ubah}î(h]îh!]îh#]îh%]îh']îuh)h+hh*hK)hjB��ubah}î(h]îh!]îh#]îh%]îh']îuh)h∞hj(��ubeh}î(h]îh!]îh#]îh%]îh']îuh)h´hhÓubh¨)Åî}î(hhh]î(h±)Åî}î(hhh]îh,)Åî}î(hådocidîh]îhådocidîÖîÅî}î(hjg��hje��ubah}î(h]îh!]îh#]îh%]îh']îuh)h+hh*hK+hjb��ubah}î(h]îh!]îh#]îh%]îh']îuh)h∞hj_��ubh±)Åî}î(hhh]îh,)Åî}î(hå.Restrict the report to this docid (repeatable)îh]îhå.Restrict the report to this docid (repeatable)îÖîÅî}î(hj~��hj|��ubah}î(h]îh!]îh#]îh%]îh']îuh)h+hh*hK+hjy��ubah}î(h]îh!]îh#]îh%]îh']îuh)h∞hj_��ubeh}î(h]îh!]îh#]îh%]îh']îuh)h´hhÓubh¨)Åî}î(hhh]î(h±)Åî}î(hhh]îh,)Åî}î(håeventîh]îhåeventîÖîÅî}î(hjû��hjú��ubah}î(h]îh!]îh#]îh%]îh']îuh)h+hh*hK-hjô��ubah}î(h]îh!]îh#]îh%]îh']îuh)h∞hjñ��ubh±)Åî}î(hhh]îh,)Åî}î(håXRestrict the report to this event type (repeatable)
Values: insert, update, delete, readîh]îhåXRestrict the report to this event type (repeatable)
Values: insert, update, delete, readîÖîÅî}î(hjµ��hj≥��ubah}î(h]îh!]îh#]îh%]îh']îuh)h+hh*hK-hj∞��ubah}î(h]îh!]îh#]îh%]îh']îuh)h∞hjñ��ubeh}î(h]îh!]îh#]îh%]îh']îuh)h´hhÓubh¨)Åî}î(hhh]î(h±)Åî}î(hhh]îh,)Åî}î(håstartîh]îhåstartîÖîÅî}î(hj’��hj”��ubah}î(h]îh!]îh#]îh%]îh']îuh)h+hh*hK0hj–��ubah}î(h]îh!]îh#]îh%]îh']îuh)h∞hjÕ��ubh±)Åî}î(hhh]îh,)Åî}î(håHRestrict the report to events after this date
Value: YYYY-MM-DD+hh:mm:ssîh]îhåHRestrict the report to events after this date
Value: YYYY-MM-DD+hh:mm:ssîÖîÅî}î(hjÏ��hjÍ��ubah}î(h]îh!]îh#]îh%]îh']îuh)h+hh*hK0hjÁ��ubah}î(h]îh!]îh#]îh%]îh']îuh)h∞hjÕ��ubeh}î(h]îh!]îh#]îh%]îh']îuh)h´hhÓubh¨)Åî}î(hhh]î(h±)Åî}î(hhh]îh,)Åî}î(håendîh]îhåendîÖîÅî}î(hj��hj
��ubah}î(h]îh!]îh#]îh%]îh']îuh)h+hh*hK3hj��ubah}î(h]îh!]îh#]îh%]îh']îuh)h∞hj��ubh±)Åî}î(hhh]îh,)Åî}î(håJRestrict the report to events before this date.
Value: YYYY-MM-DD+hh:mm:ssîh]îhåJRestrict the report to events before this date.
Value: YYYY-MM-DD+hh:mm:ssîÖîÅî}î(hj#��hj!��ubah}î(h]îh!]îh#]îh%]îh']îuh)h+hh*hK3hj��ubah}î(h]îh!]îh#]îh%]îh']îuh)h∞hj��ubeh}î(h]îh!]îh#]îh%]îh']îuh)h´hhÓubeh}î(h]îh!]îh#]îh%]îh']îuh)hÏhhçubeh}î(h]îh!]îh#]îh%]îh']îåcolsîKuh)hãhhàubah}î(h]îh!]îh#]îh%]îh']îuh)hÜhhhhhh*hNubh,)Åî}î(hå0To view only the 'read' events, use a URL like::îh]îhå3To view only the ‚Äòread‚Äô events, use a URL like:îÖîÅî}î(hå/To view only the 'read' events, use a URL like:îhjN��hhhNhNubah}î(h]îh!]îh#]îh%]îh']îuh)h+hh*hK7hhhhubhK)Åî}î(håAhttp://some.metacat.host/context/metacat?action=getlog&event=readîh]îhåAhttp://some.metacat.host/context/metacat?action=getlog&event=readîÖîÅî}î(hhhj]��ubah}î(h]îh!]îh#]îh%]îh']îhZh[uh)hJhK9hhhhhh*ubh,)Åî}î(håETo view only the events for a particular IP address, use a URL like::îh]îhåDTo view only the events for a particular IP address, use a URL like:îÖîÅî}î(håDTo view only the events for a particular IP address, use a URL like:îhjk��hhhNhNubah}î(h]îh!]îh#]îh%]îh']îuh)h+hh*hK<hhhhubhK)Åî}î(håKhttp://some.metacat.host/context/metacat?action=getlog&ipaddress=107.9.1.31îh]îhåKhttp://some.metacat.host/context/metacat?action=getlog&ipaddress=107.9.1.31îÖîÅî}î(hhhjz��ubah}î(h]îh!]îh#]îh%]îh']îhZh[uh)hJhK>hhhhhh*ubh,)Åî}î(hå:To view only the events for a given user, use a URL like::îh]îhå9To view only the events for a given user, use a URL like:îÖîÅî}î(hå9To view only the events for a given user, use a URL like:îhjà��hhhNhNubah}î(h]îh!]îh#]îh%]îh']îuh)h+hh*hKAhhhhubhK)Åî}î(håmhttp://some.metacat.host/context/metacat?action=getlog&principal=uid=johndoe,o=NCEAS,dc=ecoinformatics,dc=orgîh]îhåmhttp://some.metacat.host/context/metacat?action=getlog&principal=uid=johndoe,o=NCEAS,dc=ecoinformatics,dc=orgîÖîÅî}î(hhhjó��ubah}î(h]îh!]îh#]îh%]îh']îhZh[uh)hJhKChhhhhh*ubh,)Åî}î(håCTo view only the events for a particular document, use a URL like::îh]îhåBTo view only the events for a particular document, use a URL like:îÖîÅî}î(håBTo view only the events for a particular document, use a URL like:îhj•��hhhNhNubah}î(h]îh!]îh#]îh%]îh']îuh)h+hh*hKFhhhhubhK)Åî}î(håDhttp://some.metacat.host/context/metacat?action=getlog&docid=knb.5.1îh]îhåDhttp://some.metacat.host/context/metacat?action=getlog&docid=knb.5.1îÖîÅî}î(hhhj¥��ubah}î(h]îh!]îh#]îh%]îh']îhZh[uh)hJhKHhhhhhh*ubh,)Åî}î(hå<To view only the events after a given date, use a URL like::îh]îhå;To view only the events after a given date, use a URL like:îÖîÅî}î(hå;To view only the events after a given date, use a URL like:îhj¬��hhhNhNubah}î(h]îh!]îh#]îh%]îh']îuh)h+hh*hKKhhhhubhK)Åî}î(håPhttp://some.metacat.host/context/metacat?action=getlog&start=2004-09-15+12:00:00îh]îhåPhttp://some.metacat.host/context/metacat?action=getlog&start=2004-09-15+12:00:00îÖîÅî}î(hhhj—��ubah}î(h]îh!]îh#]îh%]îh']îhZh[uh)hJhKMhhhhhh*ubh,)Åî}î(hå=To view only the events before a given date, use a URL like::îh]îhå<To view only the events before a given date, use a URL like:îÖîÅî}î(hå<To view only the events before a given date, use a URL like:îhjfl��hhhNhNubah}î(h]îh!]îh#]îh%]îh']îuh)h+hh*hKPhhhhubhK)Åî}î(håNhttp://some.metacat.host/context/metacat?action=getlog&end=2004-09-15+12:00:00îh]îhåNhttp://some.metacat.host/context/metacat?action=getlog&end=2004-09-15+12:00:00îÖîÅî}î(hhhjÓ��ubah}î(h]îh!]îh#]îh%]îh']îhZh[uh)hJhKRhhhhhh*ubh,)Åî}î(hå]To view the 'insert' events for September 2004 (i.e., to combine parameters) use a URL like::îh]îhå`To view the ‚Äòinsert‚Äô events for September 2004 (i.e., to combine parameters) use a URL like:îÖîÅî}î(hå\To view the 'insert' events for September 2004 (i.e., to combine parameters) use a URL like:îhj¸��hhhNhNubah}î(h]îh!]îh#]îh%]îh']îuh)h+hh*hKUhhhhubhK)Åî}î(håuhttp://some.metacat.host/context/metacat?action=getlog&event=insert&start=2004-09-01+12:00:00&end=2004-09-30+23:59:59îh]îhåuhttp://some.metacat.host/context/metacat?action=getlog&event=insert&start=2004-09-01+12:00:00&end=2004-09-30+23:59:59îÖîÅî}î(hhhj��ubah}î(h]îh!]îh#]îh%]îh']îhZh[uh)hJhKWhhhhhh*ubeh}î(h]îå
event-loggingîah!]îh#]îå
event loggingîah%]îh']îuh)h	hhhhhh*hKubah}î(h]îh!]îh#]îh%]îh']îåsourceîh*uh)håcurrent_sourceîNåcurrent_lineîNåsettingsîådocutils.frontendîåValuesîìî)Åî}î(hNå	generatorîNå	datestampîNåsource_linkîNå
source_urlîNå
toc_backlinksîh∞åfootnote_backlinksîKå
sectnum_xformîKåstrip_commentsîNåstrip_elements_with_classesîNå
strip_classesîNåreport_levelîKå
halt_levelîKåexit_status_levelîKådebugîNåwarning_streamîNå	tracebackîàåinput_encodingîå	utf-8-sigîåinput_encoding_error_handlerîåstrictîåoutput_encodingîåutf-8îåoutput_encoding_error_handlerîjC��åerror_encodingîåUTF-8îåerror_encoding_error_handlerîåbackslashreplaceîå
language_codeîåenîårecord_dependenciesîNåconfigîNå	id_prefixîhåauto_id_prefixîåidîå
dump_settingsîNådump_internalsîNådump_transformsîNådump_pseudo_xmlîNåexpose_internalsîNåstrict_visitorîNå_disable_configîNå_sourceîh*å_destinationîNå
_config_filesî]îåpep_referencesîNåpep_base_urlîå https://www.python.org/dev/peps/îåpep_file_url_templateîåpep-%04dîårfc_referencesîNårfc_base_urlîåhttps://tools.ietf.org/html/îå	tab_widthîKåtrim_footnote_reference_spaceîâåfile_insertion_enabledîàåraw_enabledîKåsyntax_highlightîålongîåsmart_quotesîàåsmartquotes_localesîNåcharacter_level_inline_markupîâådoctitle_xformîâå
docinfo_xformîKåsectsubtitle_xformîâåembed_stylesheetîâåcloak_email_addressesîàåenvîNågettext_compactîàubåreporterîNåindirect_targetsî]îåsubstitution_defsî}îåsubstitution_namesî}îårefnamesî}îårefidsî}îånameidsî}îj��j��så	nametypesî}îj��Nsh}îj��hså
footnote_refsî}îå
citation_refsî}îå
autofootnotesî]îåautofootnote_refsî]îåsymbol_footnotesî]îåsymbol_footnote_refsî]îå	footnotesî]îå	citationsî]îåautofootnote_startîKåsymbol_footnote_startîK�åid_startîKåparse_messagesî]îåtransform_messagesî]îåtransformerîNå
decorationîNhhub.