Skip to content

Commit 9d41307

Browse files
iljarotariljarotar
authored
Add event service (#77)
1 parent 178f0e2 commit 9d41307

File tree

14 files changed

+1391
-0
lines changed

14 files changed

+1391
-0
lines changed

‎doc/index.html‎

Lines changed: 275 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1945,6 +1945,41 @@ <h2>Table of Contents</h2>
19451945
</li>
19461946

19471947

1948+
<li>
1949+
<a href="#metalstack%2finfra%2fv2%2fevent.proto">metalstack/infra/v2/event.proto</a>
1950+
<ul>
1951+
1952+
<li>
1953+
<a href="#metalstack.infra.v2.EventServiceSendRequest"><span class="badge">M</span>EventServiceSendRequest</a>
1954+
</li>
1955+
1956+
<li>
1957+
<a href="#metalstack.infra.v2.EventServiceSendRequest.EventsEntry"><span class="badge">M</span>EventServiceSendRequest.EventsEntry</a>
1958+
</li>
1959+
1960+
<li>
1961+
<a href="#metalstack.infra.v2.EventServiceSendResponse"><span class="badge">M</span>EventServiceSendResponse</a>
1962+
</li>
1963+
1964+
<li>
1965+
<a href="#metalstack.infra.v2.MachineProvisioningEvent"><span class="badge">M</span>MachineProvisioningEvent</a>
1966+
</li>
1967+
1968+
1969+
<li>
1970+
<a href="#metalstack.infra.v2.ProvisioningEventType"><span class="badge">E</span>ProvisioningEventType</a>
1971+
</li>
1972+
1973+
1974+
1975+
<li>
1976+
<a href="#metalstack.infra.v2.EventService"><span class="badge">S</span>EventService</a>
1977+
</li>
1978+
1979+
</ul>
1980+
</li>
1981+
1982+
19481983
<li>
19491984
<a href="#metalstack%2finfra%2fv2%2fswitch.proto">metalstack/infra/v2/switch.proto</a>
19501985
<ul>
@@ -15317,6 +15352,246 @@ <h3 id="metalstack.infra.v2.BMCService">BMCService</h3>
1531715352

1531815353

1531915354

15355+
<div class="file-heading">
15356+
<h2 id="metalstack/infra/v2/event.proto">metalstack/infra/v2/event.proto</h2><a href="#title">Top</a>
15357+
</div>
15358+
<p></p>
15359+
15360+
15361+
<h3 id="metalstack.infra.v2.EventServiceSendRequest">EventServiceSendRequest</h3>
15362+
<p>EventServiceSendRequest.</p>
15363+
15364+
15365+
<table class="field-table">
15366+
<thead>
15367+
<tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
15368+
</thead>
15369+
<tbody>
15370+
15371+
<tr>
15372+
<td>events</td>
15373+
<td><a href="#metalstack.infra.v2.EventServiceSendRequest.EventsEntry">EventServiceSendRequest.EventsEntry</a></td>
15374+
<td>repeated</td>
15375+
<td><p>Events grouped by machine IDs. </p></td>
15376+
</tr>
15377+
15378+
</tbody>
15379+
</table>
15380+
15381+
15382+
15383+
15384+
15385+
<h3 id="metalstack.infra.v2.EventServiceSendRequest.EventsEntry">EventServiceSendRequest.EventsEntry</h3>
15386+
<p></p>
15387+
15388+
15389+
<table class="field-table">
15390+
<thead>
15391+
<tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
15392+
</thead>
15393+
<tbody>
15394+
15395+
<tr>
15396+
<td>key</td>
15397+
<td><a href="#string">string</a></td>
15398+
<td></td>
15399+
<td><p> </p></td>
15400+
</tr>
15401+
15402+
<tr>
15403+
<td>value</td>
15404+
<td><a href="#metalstack.infra.v2.MachineProvisioningEvent">MachineProvisioningEvent</a></td>
15405+
<td></td>
15406+
<td><p> </p></td>
15407+
</tr>
15408+
15409+
</tbody>
15410+
</table>
15411+
15412+
15413+
15414+
15415+
15416+
<h3 id="metalstack.infra.v2.EventServiceSendResponse">EventServiceSendResponse</h3>
15417+
<p>EventServiceSendResponse.</p>
15418+
15419+
15420+
<table class="field-table">
15421+
<thead>
15422+
<tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
15423+
</thead>
15424+
<tbody>
15425+
15426+
<tr>
15427+
<td>events</td>
15428+
<td><a href="#uint64">uint64</a></td>
15429+
<td></td>
15430+
<td><p>Events counts the number of events successfully stored in the database. </p></td>
15431+
</tr>
15432+
15433+
<tr>
15434+
<td>failed</td>
15435+
<td><a href="#string">string</a></td>
15436+
<td>repeated</td>
15437+
<td><p>Failed contains IDs of all machines whose events could not be stored in the database. </p></td>
15438+
</tr>
15439+
15440+
</tbody>
15441+
</table>
15442+
15443+
15444+
15445+
15446+
15447+
<h3 id="metalstack.infra.v2.MachineProvisioningEvent">MachineProvisioningEvent</h3>
15448+
<p>MachineProvisioningEvent contains details about an event.</p>
15449+
15450+
15451+
<table class="field-table">
15452+
<thead>
15453+
<tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
15454+
</thead>
15455+
<tbody>
15456+
15457+
<tr>
15458+
<td>time</td>
15459+
<td><a href="#google.protobuf.Timestamp">google.protobuf.Timestamp</a></td>
15460+
<td></td>
15461+
<td><p>Time the event occurred at. </p></td>
15462+
</tr>
15463+
15464+
<tr>
15465+
<td>event</td>
15466+
<td><a href="#metalstack.infra.v2.ProvisioningEventType">ProvisioningEventType</a></td>
15467+
<td></td>
15468+
<td><p>Event that occurred. </p></td>
15469+
</tr>
15470+
15471+
<tr>
15472+
<td>message</td>
15473+
<td><a href="#string">string</a></td>
15474+
<td></td>
15475+
<td><p>Message describing the event in more detail. </p></td>
15476+
</tr>
15477+
15478+
</tbody>
15479+
</table>
15480+
15481+
15482+
15483+
15484+
15485+
15486+
15487+
<h3 id="metalstack.infra.v2.ProvisioningEventType">ProvisioningEventType</h3>
15488+
<p>ProvisioningEventType is a short description of a machine event.</p>
15489+
<table class="enum-table">
15490+
<thead>
15491+
<tr><td>Name</td><td>Number</td><td>Description</td></tr>
15492+
</thead>
15493+
<tbody>
15494+
15495+
<tr>
15496+
<td>PROVISIONING_EVENT_TYPE_UNSPECIFIED</td>
15497+
<td>0</td>
15498+
<td><p>PROVISIONING_EVENT_TYPE_UNSPECIFIED is unspecified.</p></td>
15499+
</tr>
15500+
15501+
<tr>
15502+
<td>PROVISIONING_EVENT_TYPE_ALIVE</td>
15503+
<td>1</td>
15504+
<td><p>PROVISIONING_EVENT_TYPE_ALIVE means the machine has reported itself to the API not long ago.</p></td>
15505+
</tr>
15506+
15507+
<tr>
15508+
<td>PROVISIONING_EVENT_TYPE_CRASHED</td>
15509+
<td>2</td>
15510+
<td><p>PROVISIONING_EVENT_TYPE_CRASHED means an irregularity in the machine&#39;s lifecycle.</p></td>
15511+
</tr>
15512+
15513+
<tr>
15514+
<td>PROVISIONING_EVENT_TYPE_PXE_BOOTING</td>
15515+
<td>3</td>
15516+
<td><p>PROVISIONING_EVENT_TYPE_PXE_BOOTING is sent when an unprovisioned machine requests a boot image via PXE.</p></td>
15517+
</tr>
15518+
15519+
<tr>
15520+
<td>PROVISIONING_EVENT_TYPE_PLANNED_REBOOT</td>
15521+
<td>4</td>
15522+
<td><p>PROVISIONING_EVENT_TYPE_PLANNED_REBOOT means the machine was scheduled for reboot.</p></td>
15523+
</tr>
15524+
15525+
<tr>
15526+
<td>PROVISIONING_EVENT_TYPE_PREPARING</td>
15527+
<td>5</td>
15528+
<td><p>PROVISIONING_EVENT_TYPE_PREPARING means the metal-hammer has started.</p></td>
15529+
</tr>
15530+
15531+
<tr>
15532+
<td>PROVISIONING_EVENT_TYPE_REGISTERING</td>
15533+
<td>6</td>
15534+
<td><p>PROVISIONING_EVENT_TYPE_REGISTERING means the metal-hammer is attempting to register the machine at the API.</p></td>
15535+
</tr>
15536+
15537+
<tr>
15538+
<td>PROVISIONING_EVENT_TYPE_WAITING</td>
15539+
<td>7</td>
15540+
<td><p>PROVISIONING_EVENT_TYPE_WAITING means the machine has successfully reached the state where it is waiting for allocation.</p></td>
15541+
</tr>
15542+
15543+
<tr>
15544+
<td>PROVISIONING_EVENT_TYPE_INSTALLING</td>
15545+
<td>8</td>
15546+
<td><p>PROVISIONING_EVENT_TYPE_INSTALLING means the machine was allocated and the requested OS is being installed.</p></td>
15547+
</tr>
15548+
15549+
<tr>
15550+
<td>PROVISIONING_EVENT_TYPE_BOOTING_NEW_KERNEL</td>
15551+
<td>9</td>
15552+
<td><p>PROVISIONING_EVENT_TYPE_BOOTING_NEW_KERNEL means the machine has successfully been installed and is now booting into the new OS.</p></td>
15553+
</tr>
15554+
15555+
<tr>
15556+
<td>PROVISIONING_EVENT_TYPE_PHONED_HOME</td>
15557+
<td>10</td>
15558+
<td><p>PROVISIONING_EVENT_TYPE_PHONED_HOME is sent periodically by an allocated machine to indicate its liveliness.</p></td>
15559+
</tr>
15560+
15561+
<tr>
15562+
<td>PROVISIONING_EVENT_TYPE_MACHINE_RECLAIM</td>
15563+
<td>11</td>
15564+
<td><p>PROVISIONING_EVENT_TYPE_MACHINE_RECLAIM means the machine was freed and is about to return into the pool of waiting machines.</p></td>
15565+
</tr>
15566+
15567+
</tbody>
15568+
</table>
15569+
15570+
15571+
15572+
15573+
15574+
<h3 id="metalstack.infra.v2.EventService">EventService</h3>
15575+
<p>EventService serves event related functions.</p>
15576+
<table class="enum-table">
15577+
<thead>
15578+
<tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
15579+
</thead>
15580+
<tbody>
15581+
15582+
<tr>
15583+
<td>Send</td>
15584+
<td><a href="#metalstack.infra.v2.EventServiceSendRequest">EventServiceSendRequest</a></td>
15585+
<td><a href="#metalstack.infra.v2.EventServiceSendResponse">EventServiceSendResponse</a></td>
15586+
<td><p>Send a series of machine provisioning events.</p></td>
15587+
</tr>
15588+
15589+
</tbody>
15590+
</table>
15591+
15592+
15593+
15594+
1532015595
<div class="file-heading">
1532115596
<h2 id="metalstack/infra/v2/switch.proto">metalstack/infra/v2/switch.proto</h2><a href="#title">Top</a>
1532215597
</div>

‎go/client/client.go‎

Lines changed: 11 additions & 0 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)