Bug 1296199 - [DOCS] Improve information on Events
Summary: [DOCS] Improve information on Events
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: OpenShift Container Platform
Classification: Red Hat
Component: Documentation
Version: 3.1.0
Hardware: Unspecified
OS: Unspecified
medium
high
Target Milestone: ---
: ---
Assignee: Ashley Hardin
QA Contact: Wang Haoran
Vikram Goyal
URL:
Whiteboard:
Depends On:
Blocks: 1267746 1296200
TreeView+ depends on / blocked
 
Reported: 2016-01-06 15:14 UTC by Eric Rich
Modified: 2019-09-12 09:41 UTC (History)
9 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
: 1296200 (view as bug list)
Environment:
Last Closed: 2016-09-07 20:07:08 UTC
Target Upstream Version:
Embargoed:
tnguyen: needinfo-


Attachments (Terms of Use)

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


Note You need to log in before you can comment on or make changes to this bug.