€•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 4434.237.20.142uid=jones, o=NCEAS,dc=ecoinformatics,dc=orgesa.2.1insert 2004-09-08 19:08:18.16 4734.237.20.142uid=jones,o=NCEAS, dc=ecoinformatics,dc=orgesa.3.1insert2004- 09-14 19:50:40.61 ”h]”hX 4434.237.20.142uid=jones, o=NCEAS,dc=ecoinformatics,dc=orgesa.2.1insert 2004-09-08 19:08:18.16 4734.237.20.142uid=jones,o=NCEAS, dc=ecoinformatics,dc=orgesa.3.1insert2004- 09-14 19:50:40.61 ”…””}”(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)hhhubh‘)”}”(hhh]”h}”(h]”h!]”h#]”h%]”h']”Œcolwidth”K5uh)hhhubhŒ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°hhubh±)”}”(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°hhubeh}”(h]”h!]”h#]”h%]”h']”uh)h«hh¨ubah}”(h]”h!]”h#]”h%]”h']”uh)h¦hhubhŒ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)”…””}”(hjhjubah}”(h]”h!]”h#]”h%]”h']”uh)h+hh*hK'hjubah}”(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”…””}”(hj0hj.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)”…””}”(hjGhjEubah}”(h]”h!]”h#]”h%]”h']”uh)h+hh*hK)hjBubah}”(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”…””}”(hjghjeubah}”(h]”h!]”h#]”h%]”h']”uh)h+hh*hK+hjbubah}”(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+hjyubah}”(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”…””}”(hjhj ubah}”(h]”h!]”h#]”h%]”h']”uh)h+hh*hK3hjubah}”(h]”h!]”h#]”h%]”h']”uh)h°hjubh±)”}”(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*hK3hjubah}”(h]”h!]”h#]”h%]”h']”uh)h°hjubeh}”(h]”h!]”h#]”h%]”h']”uh)h«hhîubeh}”(h]”h!]”h#]”h%]”h']”uh)hìhhubeh}”(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:”hjNhhhNhNubah}”(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:”hjkhhhNhNubah}”(h]”h!]”h#]”h%]”h']”uh)h+hh*hKhhhhhh*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Œ