1{
2    "title": "PEL message registry schema",
3    "$id": "http://github.com/openbmc/phosphor-logging/extensions/openpower-pels/registry/schema/schema.json",
4    "description": "This schema describes JSON used for creating PELs from OpenBMC event logs.",
5    "type": "object",
6
7    "properties": {
8        "PELs": {
9            "title": "This is an array of entries that specify PEL fields for event logs",
10            "$ref": "#/definitions/pels"
11        }
12    },
13
14    "additionalProperties": false,
15    "minItems": 1,
16    "uniqueItems": true,
17
18    "definitions": {
19        "pels": {
20            "description": "Each entry in this array is for converting an event log to a PEL",
21            "type": "array",
22            "items": {
23                "description": "The schema for a single event log registry entry",
24                "type": "object",
25                "properties": {
26                    "Name": { "$ref": "#/definitions/errorName" },
27
28                    "SRC": { "$ref": "#/definitions/src" },
29
30                    "Subsystem": { "$ref": "#/definitions/subsystem" },
31
32                    "PossibleSubsystems": {
33                        "$ref": "#/definitions/possibleSubsystems"
34                    },
35
36                    "Severity": { "$ref": "#/definitions/severity" },
37
38                    "MfgSeverity": { "$ref": "#/definitions/mfgSeverity" },
39
40                    "EventScope": { "$ref": "#/definitions/eventScope" },
41
42                    "EventType": { "$ref": "#/definitions/eventType" },
43
44                    "ActionFlags": { "$ref": "#/definitions/actionFlags" },
45
46                    "MfgActionFlags": {
47                        "$ref": "#/definitions/mfgActionFlags"
48                    },
49
50                    "Documentation": { "$ref": "#/definitions/documentation" },
51
52                    "ComponentID": { "$ref": "#/definitions/componentID" },
53
54                    "CalloutsUsingAD": {
55                        "$ref": "#/definitions/calloutsUsingAD"
56                    },
57
58                    "Callouts": { "$ref": "#/definitions/callouts" },
59
60                    "JournalCapture": { "$ref": "#/definitions/journalCapture" }
61                },
62
63                "required": ["Name", "SRC", "Documentation"],
64                "additionalProperties": false,
65
66                "not": {
67                    "required": ["CalloutsUsingAD", "Callouts"]
68                },
69
70                "oneOf": [
71                    {
72                        "required": ["Subsystem"]
73                    },
74                    {
75                        "required": ["PossibleSubsystems"]
76                    }
77                ]
78            }
79        },
80
81        "errorName": {
82            "description": "The 'Message' property of an OpenBMC event log",
83            "type": "string"
84        },
85
86        "componentID": {
87            "description": "The component ID of the PEL creator, in the form 0xYY00.  For BD SRCs, this is optional and if not present the component ID will be taken from the upper byte of the reason code.",
88            "type": "string",
89            "pattern": "^0x[0-9A-F]{2}00$"
90        },
91
92        "src": {
93            "description": "Contains fields describing the primary SRC embedded in the PEL",
94            "type": "object",
95
96            "properties": {
97                "Type": { "$ref": "#/definitions/srcType" },
98
99                "ReasonCode": { "$ref": "#/definitions/reasonCode" },
100
101                "SymptomIDFields": { "$ref": "#/definitions/symptomID" },
102
103                "Words6To9": { "$ref": "#/definitions/srcWords6To9" },
104
105                "DeconfigFlag": { "$ref": "#/definitions/deconfigFlag" },
106
107                "CheckstopFlag": { "$ref": "#/definitions/checkstopFlag" }
108            },
109
110            "required": ["ReasonCode", "Words6To9"],
111            "additionalProperties": false
112        },
113
114        "documentation": {
115            "description": "This contains event documentation that will be used by tools and parsers.",
116            "type": "object",
117
118            "properties": {
119                "Message": { "$ref": "#/definitions/docMessage" },
120
121                "MessageArgSources": {
122                    "$ref": "#/definitions/docMessageArgSources"
123                },
124
125                "Description": { "$ref": "#/definitions/docDescription" },
126
127                "Notes": { "$ref": "#/definitions/docNotes" }
128            },
129            "additionalProperties": false,
130            "required": ["Message", "Description"]
131        },
132
133        "srcType": {
134            "description": "The first byte of the SRC ASCII string. Optional and defaults to BD.  The '11' SRC is only to be used for events related to power.",
135            "type": "string",
136            "enum": ["BD", "11"]
137        },
138
139        "deconfigFlag": {
140            "description": "If true, will set bit 6 in hex data word 5, which means 'one or more resources are deconfigured'.",
141            "type": "boolean"
142        },
143
144        "checkstopFlag": {
145            "description": "Indicates the SRC is for a hardware checkstop.",
146            "type": "boolean"
147        },
148
149        "docNotes": {
150            "description": "Any notes/comments about the error. An array of strings for manual line wrapping. Optional.",
151            "type": "array",
152            "items": {
153                "description": "Notes",
154                "type": "string"
155            }
156        },
157
158        "reasonCode": {
159            "description": "String representation of the 2 byte reason code, like 0xABCD.  The reason code is the 2nd half of the 8 character SRC ASCII String field, such as B1FFABCD.",
160            "type": "string",
161            "pattern": "^0x[0-9A-F]{4}$",
162
163            "examples": ["0x3355"]
164        },
165
166        "subsystem": {
167            "description": "PEL subsystem enumeration.  See the PEL spec for more detailed definitions.",
168            "type": "string",
169            "enum": [
170                "processor",
171                "processor_fru",
172                "processor_chip",
173                "processor_unit",
174                "processor_bus",
175
176                "memory",
177                "memory_ctlr",
178                "memory_bus",
179                "memory_dimm",
180                "memory_fru",
181                "external_cache",
182
183                "io",
184                "io_hub",
185                "io_bridge",
186                "io_bus",
187                "io_processor",
188                "io_hub_other",
189                "phb",
190
191                "io_adapter",
192                "io_adapter_comm",
193                "io_device",
194                "io_device_dasd",
195                "io_external_general",
196                "io_external_workstation",
197                "io_storage_mezz",
198
199                "cec_hardware",
200                "cec_sp_a",
201                "cec_sp_b",
202                "cec_node_controller",
203                "cec_vpd",
204                "cec_i2c",
205                "cec_chip_iface",
206                "cec_clocks",
207                "cec_op_panel",
208                "cec_tod",
209                "cec_storage_device",
210                "cec_sp_hyp_iface",
211                "cec_service_network",
212                "cec_sp_hostboot_iface",
213
214                "power",
215                "power_supply",
216                "power_control_hw",
217                "power_fans",
218                "power_sequencer",
219
220                "others",
221                "other_hmc",
222                "other_test_tool",
223                "other_media",
224                "other_multiple_subsystems",
225                "other_na",
226                "other_info_src",
227
228                "surv_hyp_lost_sp",
229                "surv_sp_lost_hyp",
230                "surv_sp_lost_hmc",
231                "surv_hmc_lost_lpar",
232                "surv_hmc_lost_bpa",
233                "surv_hmc_lost_hmc",
234
235                "platform_firmware",
236                "bmc_firmware",
237                "hyp_firmware",
238                "partition_firmware",
239                "slic_firmware",
240                "spcn_firmware",
241                "bulk_power_firmware_side_a",
242                "hmc_code_firmware",
243                "bulk_power_firmware_side_b",
244                "virtual_sp",
245                "hostboot",
246                "occ",
247
248                "software",
249                "os_software",
250                "xpf_software",
251                "app_software",
252
253                "ext_env",
254                "input_power_source",
255                "ambient_temp",
256                "user_error",
257                "corrosion"
258            ]
259        },
260
261        "possibleSubsystems": {
262            "description": "Required when the PEL creator uses PEL_SUBSYSTEM in the AdditionalData property to pass in the subsystem.  Used by scripts that generate documentation to build all possible SRC ASCII strings for this error.",
263            "type": "array",
264            "items": {
265                "$ref": "#/definitions/subsystem"
266            },
267            "minItems": 1,
268            "uniqueItems": true
269        },
270
271        "systemAndSeverity": {
272            "description": "A severity entry that has an optional system type qualifier.  Used when the severity needs to be based on the system type.",
273            "type": "object",
274            "properties": {
275                "System": { "$ref": "#/definitions/system" },
276                "SevValue": { "$ref": "#/definitions/severityTypes" }
277            },
278            "additionalProperties": false,
279            "required": ["SevValue"]
280        },
281
282        "severity": {
283            "description": "PEL severity field.  Optional.  If not provided, it will use the event log severity. It can either be an enum of the severity value, or an array of them that is based on system type, where an entry without a system type acts as the catch all.",
284            "oneOf": [
285                {
286                    "$ref": "#/definitions/severityTypes"
287                },
288                {
289                    "type": "array",
290                    "items": {
291                        "$ref": "#/definitions/systemAndSeverity"
292                    },
293                    "minItems": 1,
294                    "uniqueItems": true
295                }
296            ],
297
298            "examples": [
299                "unrecoverable",
300
301                [
302                    {
303                        "System": "systemA",
304                        "SevValue": "predictive"
305                    },
306                    {
307                        "SevValue": "unrecoverable"
308                    }
309                ]
310            ]
311        },
312
313        "severityTypes": {
314            "description": "PEL severity enumeration.  See the PEL spec for more detailed definitions.",
315            "type": "string",
316
317            "enum": [
318                "non_error",
319
320                "recovered",
321
322                "predictive",
323                "predictive_degraded_perf",
324                "predictive_reboot",
325                "predictive_reboot_degraded",
326                "predictive_redundancy_loss",
327
328                "unrecoverable",
329                "unrecoverable_degraded_perf",
330                "unrecoverable_redundancy_loss",
331                "unrecoverable_redundancy_loss_perf",
332                "unrecoverable_loss_of_function",
333
334                "critical",
335                "critical_system_term",
336                "critical_imminent_failure",
337                "critical_partition_term",
338                "critical_partition_imminent_failure",
339
340                "diagnostic_error",
341                "diagnostic_error_incorrect_results",
342
343                "symptom_recovered",
344                "symptom_predictive",
345                "symptom_unrecoverable",
346                "symptom_critical",
347                "symptom_diag_err"
348            ]
349        },
350
351        "mfgSeverity": {
352            "description": "The PEL severity to use in manufacturing reporting mode",
353            "$ref": "#/definitions/severity"
354        },
355
356        "eventScope": {
357            "description": "The event scope PEL field. Optional and defaults to entire_platform",
358            "type": "string",
359            "enum": [
360                "entire_platform",
361                "single_partition",
362                "multiple_partitions",
363                "possibly_multiple_platforms"
364            ]
365        },
366
367        "eventType": {
368            "description": "The event type PEL field. Optional and defaults to na",
369            "type": "string",
370            "enum": [
371                "na",
372                "misc_information_only",
373                "tracing_event",
374                "dump_notification",
375                "env_normal"
376            ]
377        },
378
379        "actionFlags": {
380            "description": "The action flags Private Header PEL field",
381            "type": "array",
382            "items": {
383                "description": "List of action flags",
384                "type": "string",
385                "enum": [
386                    "service_action",
387                    "hidden",
388                    "report",
389                    "dont_report",
390                    "call_home",
391                    "isolation_incomplete",
392                    "termination",
393                    "heartbeat_call_home"
394                ]
395            }
396        },
397
398        "mfgActionFlags": {
399            "description": "The PEL action flags to use in manufacturing reporting mode",
400            "$ref": "#/definitions/actionFlags"
401        },
402
403        "docDescription": {
404            "description": "This is a higher level description of the error.  It is required by the Redfish schema to generate a Redfish message entry, but is not used in Redfish or PEL output.",
405            "type": "string",
406            "minLength": 8
407        },
408
409        "docMessage": {
410            "description": "The error message.  This will show up in parsed PELs, and in the Redfish event logs.  It can contain placeholders for numeric values using %1, %2, etc, that come from the SRC words 6-9 as defined by the MessageArgSources property.",
411            "type": "string",
412            "minLength": 8,
413            "examples": [
414                { "Message": "The code update from level %1 to %2 failed" }
415            ]
416        },
417
418        "docMessageArgSources": {
419            "description": "The SRC word 6-9 to use as the source of the numeric arguments that will be substituted into any placeholder in the Message field.  Only required if there are arguments to substitute.",
420            "type": "array",
421            "items": {
422                "type": "string",
423                "enum": ["SRCWord6", "SRCWord7", "SRCWord8", "SRCWord9"]
424            },
425            "additionalItems": false
426        },
427
428        "symptomID": {
429            "description": "Defines a custom Symptom ID, to be appended to the ASCII string word and separated by underscores.  The maximum size of the Symptom ID field is 80 characters.  The default is ASCIISTRING_SRCWord3 (e.g. B1103500_12345678).",
430            "type": "array",
431            "items": {
432                "type": "string",
433                "enum": [
434                    "SRCWord3",
435                    "SRCWord4",
436                    "SRCWord5",
437                    "SRCWord6",
438                    "SRCWord7",
439                    "SRCWord8",
440                    "SRCWord9"
441                ]
442            },
443            "minItems": 1,
444            "maxItems": 8,
445            "uniqueItems": true,
446
447            "examples": [["SRCWord3", "SRCWord6"]]
448        },
449
450        "srcWords6To9": {
451            "description": "This details what the user defined SRC hex words (6-9) mean, and which AdditionalData properties to get them from.  These will be shown in the PEL parser output.  Must be present, but can be empty.",
452            "type": "object",
453            "patternProperties": {
454                "^[6-9]$": {
455                    "type": "object",
456                    "properties": {
457                        "Description": {
458                            "description": "What the value in the field represents.",
459                            "type": "string"
460                        },
461                        "AdditionalDataPropSource": {
462                            "description": "Which AdditionalData property key to get the data from.",
463                            "type": "string"
464                        }
465                    },
466
467                    "additionalProperties": false
468                },
469
470                "examples": {
471                    "SRCWords6To9": {
472                        "6": {
473                            "Description": "Failing PSU number",
474                            "AdditionalDataPropSource": "PSU_NUM"
475                        }
476                    }
477                }
478            },
479            "additionalProperties": false
480        },
481
482        "adName": {
483            "description": "The name of the AdditionalData entry to use to index into the callout tables.",
484            "type": "string"
485        },
486
487        "adValue": {
488            "description": "The value for the AdditionalData entry specified by ADName that indexes into the callout tables.",
489            "type": "string"
490        },
491
492        "locationCode": {
493            "description": "A location code - the segment after the 'UTMS-' prefix. (e.g. P1-C2)",
494            "type": "string"
495        },
496
497        "priority": {
498            "description": "The callout priority.  See the PEL spec for priority definitions.",
499            "type": "string",
500            "enum": [
501                "high",
502                "medium",
503                "low",
504                "medium_group_a",
505                "medium_group_b",
506                "medium_group_c"
507            ]
508        },
509
510        "symbolicFRU": {
511            "description": "The symbolic FRU callout.",
512            "type": "string",
513            "enum": [
514                "service_docs",
515                "pwrsply",
516                "air_mover",
517                "pgood_part",
518                "usb_pgood",
519                "ambient_temp",
520                "ambient_temp_back",
521                "ambient_perf_loss",
522                "ac_module",
523                "fan_cable",
524                "cable_continued",
525                "altitude",
526                "pcie_hot_plug",
527                "overtemp",
528                "memory_dimm"
529            ]
530        },
531
532        "symbolicFRUTrusted": {
533            "description": "The symbolic FRU callout with a trusted location code. (Can light LEDs).",
534            "ref": "#/definitions/symbolicFRU"
535        },
536
537        "procedure": {
538            "description": "The maintenance procedure callout. List of available procedures is at https://github.com/ibm-openbmc/openpower-pel-parsers/blob/master/modules/calloutparsers/ocallouts/ocallouts.py ",
539            "type": "string"
540        },
541
542        "useInventoryLocCode": {
543            "description": "Used along with SymbolicFRUTrusted to specify that the location code to use with the symbolic FRU is to be taken from the passed in CALLOUT_INVENTORY_PATH callout rather than being specified with LocCode.",
544            "type": "boolean"
545        },
546
547        "calloutList": {
548            "description": "The list of FRU callouts to add to a PEL.  If just LocCode is specified, it is a normal hardware FRU callout.  If Procedure is specified, it is a procedure callout.  If SymbolicFRU or SymbolicFRUTrusted are specified, it is a Symbolic FRU callout.  SymbolicFRUTrusted also requires LocCode.",
549            "type": "array",
550            "items": {
551                "type": "object",
552                "properties": {
553                    "Priority": { "$ref": "#/definitions/priority" },
554                    "LocCode": { "$ref": "#/definitions/locationCode" },
555                    "SymbolicFRU": { "$ref": "#/definitions/symbolicFRU" },
556                    "SymbolicFRUTrusted": {
557                        "$ref": "#/definitions/symbolicFRUTrusted"
558                    },
559                    "Procedure": { "$ref": "#/definitions/procedure" },
560                    "UseInventoryLocCode": {
561                        "$ref": "#/definitions/useInventoryLocCode"
562                    }
563                },
564                "additionalProperties": false,
565                "required": ["Priority"],
566
567                "oneOf": [
568                    {
569                        "allOf": [
570                            { "required": ["LocCode"] },
571                            { "not": { "required": ["SymbolicFRU"] } },
572                            { "not": { "required": ["SymbolicFRUTrusted"] } },
573                            { "not": { "required": ["Procedure"] } },
574                            { "not": { "required": ["UseInventoryLocCode"] } }
575                        ]
576                    },
577                    {
578                        "allOf": [
579                            { "required": ["SymbolicFRU"] },
580                            { "not": { "required": ["SymbolicFRUTrusted"] } },
581                            { "not": { "required": ["Procedure"] } },
582                            { "not": { "required": ["UseInventoryLocCode"] } }
583                        ]
584                    },
585
586                    {
587                        "allOf": [
588                            { "required": ["SymbolicFRUTrusted", "LocCode"] },
589                            { "not": { "required": ["SymbolicFRU"] } },
590                            { "not": { "required": ["Procedure"] } },
591                            { "not": { "required": ["UseInventoryLocCode"] } }
592                        ]
593                    },
594
595                    {
596                        "allOf": [
597                            {
598                                "required": [
599                                    "SymbolicFRUTrusted",
600                                    "UseInventoryLocCode"
601                                ]
602                            },
603                            { "not": { "required": ["SymbolicFRU"] } },
604                            { "not": { "required": ["Procedure"] } },
605                            { "not": { "required": ["LocCode"] } }
606                        ]
607                    },
608
609                    {
610                        "allOf": [
611                            { "required": ["Procedure"] },
612                            { "not": { "required": ["SymbolicFRU"] } },
613                            { "not": { "required": ["SymbolicFRUTrusted"] } },
614                            { "not": { "required": ["LocCode"] } },
615                            { "not": { "required": ["UseInventoryLocCode"] } }
616                        ]
617                    }
618                ]
619            },
620            "minItems": 1,
621            "maxItems": 10,
622
623            "examples": [
624                {
625                    "Priority": "high",
626                    "LocCode": "P1"
627                },
628                {
629                    "Priority": "medium",
630                    "LocCode": "P2",
631                    "SymbolicFRU": "PROCFRU"
632                },
633                {
634                    "Priority": "low",
635                    "Procedure": "SVCDOCS"
636                }
637            ]
638        },
639
640        "system": {
641            "description": "The system type string, as specified by entity manger.  It is used to index into different sections of the JSON.",
642            "type": "string",
643            "minLength": 1
644        },
645
646        "systems": {
647            "description": "The Systems key can be defined and can be used to keep the name of the systems as an array of string if the systems possess same callout list.",
648            "type": "array",
649            "items": {
650                "type": "string"
651            },
652            "minItems": 1
653        },
654
655        "callouts": {
656            "description": "This contains callouts that can vary based on system type.  Each entry contains an optional System property and a required CalloutList property.  If the System property is left out it indicates that the CalloutList callouts are valid for every system type, unless there is another Callouts entry that has a matching System property, in which case that entry is valid.",
657            "type": "array",
658            "items": {
659                "type": "object",
660
661                "properties": {
662                    "System": { "$ref": "#/definitions/system" },
663                    "Systems": { "$ref": "#/definitions/systems" },
664                    "CalloutList": { "$ref": "#/definitions/calloutList" }
665                },
666                "additionalProperties": false
667            },
668            "anyOf": [
669                {
670                    "required": ["System", "CalloutList"]
671                },
672                {
673                    "required": ["Systems", "CalloutList"]
674                },
675                {
676                    "required": ["CalloutList"]
677                }
678            ],
679            "minItems": 1,
680            "maxItems": 10,
681
682            "examples": [
683                [
684                    {
685                        "System": "system1",
686                        "CalloutList": [{ "Priority": "high", "LocCode": "P1" }]
687                    },
688                    {
689                        "Systems": ["system1", "system2"],
690                        "CalloutList": [{ "Priority": "low", "LocCode": "P2" }]
691                    },
692                    {
693                        "CalloutList": [
694                            { "Priority": "high", "Procedure": "NEXTLVL" }
695                        ]
696                    }
697                ]
698            ]
699        },
700
701        "calloutsWithTheirADValues": {
702            "description": "This contains callouts along with the AdditionalData value used to select an entry into the callout list.  The AdditionalData entry was specified by ADName in the CalloutsUsingAD parent entry.",
703            "type": "array",
704
705            "items": {
706                "type": "object",
707                "properties": {
708                    "ADValue": { "$ref": "#/definitions/adValue" },
709                    "Callouts": { "$ref": "#/definitions/callouts" }
710                },
711                "additionalProperties": false,
712                "required": ["ADValue", "Callouts"]
713            },
714            "minItems": 1,
715
716            "examples": [
717                [
718                    {
719                        "ADValue": "0",
720                        "Callouts": [
721                            {
722                                "CalloutList": [
723                                    { "Priority": "high", "LocCode": "P1" }
724                                ]
725                            }
726                        ]
727                    },
728                    {
729                        "ADValue": "1",
730                        "Callouts": [
731                            {
732                                "CalloutList": [
733                                    { "Priority": "high", "LocCode": "P2" }
734                                ]
735                            }
736                        ]
737                    }
738                ]
739            ]
740        },
741
742        "calloutsUsingAD": {
743            "description": "This contains the callouts that can be specified based on a value in the AdditionalData property.",
744            "type": "object",
745
746            "properties": {
747                "ADName": { "$ref": "#/definitions/adName" },
748                "CalloutsWithTheirADValues": {
749                    "$ref": "#/definitions/calloutsWithTheirADValues"
750                },
751                "CalloutsWhenNoADMatch": {
752                    "$ref": "#/definitions/calloutsWhenNoADMatch"
753                }
754            },
755            "additionalProperties": false,
756            "required": ["ADName", "CalloutsWithTheirADValues"],
757
758            "examples": [
759                {
760                    "ADName": "PROC_NUM",
761                    "CalloutsWithTheirADValues": [
762                        {
763                            "ADValue": "0",
764                            "Callouts": [
765                                {
766                                    "CalloutList": [
767                                        { "Priority": "high", "LocCode": "P1" }
768                                    ]
769                                }
770                            ]
771                        },
772                        {
773                            "ADValue": "1",
774                            "Callouts": [
775                                {
776                                    "CalloutList": [
777                                        { "Priority": "high", "LocCode": "P2" }
778                                    ]
779                                }
780                            ]
781                        }
782                    ]
783                }
784            ]
785        },
786
787        "calloutsWhenNoADMatch": {
788            "description": "This contains the callouts to use when a match in the 'CalloutsWithTheirADValues array isn't found.",
789            "$ref": "#/definitions/callouts"
790        },
791
792        "numLines": {
793            "description": "The number of lines of the journal to capture.",
794            "type": "integer",
795            "minimum": 1,
796            "maximum": 100
797        },
798
799        "syslogID": {
800            "description": "SYSLOG_IDENTIFIER value from the journal whose entries to capture.",
801            "type": "string",
802            "minLength": 1
803        },
804
805        "journalSection": {
806            "type": "object",
807            "properties": {
808                "SyslogID": { "$ref": "#/definitions/syslogID" },
809                "NumLines": { "$ref": "#/definitions/numLines" }
810            },
811            "additionalProperties": false,
812            "required": ["SyslogID", "NumLines"]
813        },
814
815        "journalSectionList": {
816            "description": "Describes which syslog IDs and how many journal lines to capture",
817            "type": "array",
818            "items": {
819                "$ref": "#/definitions/journalSection"
820            },
821            "minItems": 1,
822            "uniqueItems": true,
823            "examples": [
824                {
825                    "Sections": [
826                        {
827                            "SyslogID": "phosphor-bmc-state-manager",
828                            "NumLines": 20
829                        }
830                    ]
831                }
832            ]
833        },
834
835        "journalCapture": {
836            "description": "Allows a PEL to capture journal data in UserData sections.",
837            "type": "object",
838            "properties": {
839                "NumLines": { "$ref": "#/definitions/numLines" },
840                "Sections": { "$ref": "#/definitions/journalSectionList" }
841            },
842            "oneOf": [
843                {
844                    "required": ["NumLines"]
845                },
846                {
847                    "required": ["Sections"]
848                }
849            ],
850            "additionalProperties": false,
851            "examples": [
852                {
853                    "JournalCapture": {
854                        "NumLines": 30
855                    }
856                },
857                {
858                    "JournalCapture": {
859                        "Sections": [
860                            {
861                                "SyslogID": "phosphor-bmc-state-manager",
862                                "NumLines": 20
863                            },
864                            {
865                                "SyslogID": "phosphor-log-manager",
866                                "NumLines": 15
867                            }
868                        ]
869                    }
870                }
871            ]
872        }
873    }
874}
875