Look for repo_name in VM link
[arvados.git] / doc / api / schema / Log.html.textile.liquid
1 ---
2 layout: default
3 navsection: api
4 navmenu: Schema
5 title: Log
6
7 ...
8
9
10
11 **Log** objects record events that occur in an Arvados cluster. Both user-written pipelines and the Arvados system itself may generate Log events.
12
13 h2. Methods
14
15 See "REST methods for working with Arvados resources":{{site.baseurl}}/api/methods.html
16
17 API endpoint base: @https://{{ site.arvados_api_host }}/arvados/v1/logs@
18
19 h2. Creation
20
21 Any user may create Log entries for any event they find useful. User-generated Logs have no intrinsic meaning to other users or to the Arvados system itself; it is up to each user to choose appropriate log event types and summaries for their project.
22
23 h3. System Logs
24
25 At the time of this writing, the Arvados system uses Logs only to record interactive user shell logins (event type @LOGIN@).
26
27 h2. Resources
28
29 Each Log has, in addition to the usual "attributes of Arvados resources":{{site.baseurl}}/api/resources.html:
30
31 table(table table-bordered table-condensed).
32 |_. Attribute|_. Type|_. Description|_. Example|
33 |object_kind|string|||
34 |object_uuid|string|||
35 |event_at|datetime|||
36 |event_type|string|A user-defined category or type for this event.|@LOGIN@|
37 |summary|text|||
38 |info|Hash|||
39 |updated_at|datetime|||