Bug 1296199

Summary: [DOCS] Improve information on Events
Product: OpenShift Container Platform Reporter: Eric Rich <erich>
Component: DocumentationAssignee: Ashley Hardin <ahardin>
Status: CLOSED CURRENTRELEASE QA Contact: Wang Haoran <haowang>
Severity: high Docs Contact: Vikram Goyal <vigoyal>
Priority: medium    
Version: 3.1.0CC: amelicha, aos-bugs, erich, jokerman, mmccomas, pep, pmorie, pweil, xtian
Target Milestone: ---Flags: tnguyen: needinfo-
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of:
: 1296200 (view as bug list) Environment:
Last Closed: 2016-09-07 20:07:08 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On:    
Bug Blocks: 1267746, 1296200    

Description Eric Rich 2016-01-06 15:14:42 UTC
Document URL: https://docs.openshift.com/enterprise/3.1/dev_guide/events.html

Section Number and Name: Events

Describe the issue: There is NO information on what events are tracked, or what "actions" are recorded as events. 

Suggestions for improvement: 

Provide information on what actions are tracked, and what events are recorded. 

How can a user / admin trigger an event and then view it with the oc get events command. 

Additional information:

Comment 4 Thien-Thi Nguyen 2016-06-03 17:35:36 UTC
Doc plan: Add a section "Comprehensive List of Events" to the dev guide "Events" chapter, with a series of tables describing the events, one per API object type.  This section is reference material and covers all the events (hence "Comprehensive" in the name).

Maintenance implication: This table MUST be updated:
- when an API object changes its set of associated events
- when an API object that has associated events is added/deleted

Paul, could you please point me to specific source code or other resources (in repo ‘openshift/origin’) that i can read to get started piecing together these tables?  I am looking to answer the questions:
- Which API objects have associated events?
- For each event, what is its Name and Description?

Comment 6 Paul Weil 2016-06-06 15:21:14 UTC
discussed in IRC.  I think the best way to get all of these events is looking for usages of the event recorder.

Comment 7 Thien-Thi Nguyen 2016-06-06 16:58:06 UTC
The event recorders in question use interface:
https://github.com/pweil-/kubernetes/blob/5f9ee58de071515a4c8b439c9ccd048dfd728c85/pkg/client/record/event.go#L54-54

Comment 8 Thien-Thi Nguyen 2016-06-08 07:51:47 UTC
PR: https://github.com/openshift/openshift-docs/pull/2235

Moving status to MODIFIED as the PR is WIP.

Comment 10 Ashley Hardin 2016-08-29 22:33:33 UTC
Work is continued in https://github.com/openshift/openshift-docs/pull/2756

Comment 11 Wang Haoran 2016-09-06 03:19:59 UTC
PR LGTM, will mark verify after the pr merged, thanks.

Comment 12 openshift-github-bot 2016-09-06 13:13:04 UTC
Commits pushed to master at https://github.com/openshift/openshift-docs

https://github.com/openshift/openshift-docs/commit/fa0f675d2d5e71788d118777ddc08d62fa45b0bd
Bug 1296199, added Comprehensive List of Events

https://github.com/openshift/openshift-docs/commit/072bbea77824be70f1b55204277c4dc7a7f52219
Merge pull request #2756 from ahardin-rh/tnguyen-rh-PR2235

Bug 1296199, added comprehensive list of events