elastic / elastic/docs-content

[Website]: FortiGate setup snippet recommends invalid CLI value `set format rfc6587`

Open Beginner friendly
#8,075 1 comment 0 reactions 0 assignees View on GitHub
source:web Team:SKI
Dominant language
No language data
Stars
47
Forks
261
Avg merge
3d 12h
Merged PRs (30d)
116

Description

### Before you submit

- [x] This issue is about a documentation page, flow, or piece of content.

### Type of issue

Inaccurate

### What documentation page or section is affected

https://www.elastic.co/docs/reference/integrations/fortinet_fortigate#vendor-set-up-steps

### What happened?

The snippet under **Vendor set up steps > Syslog Configuration > CLI Configuration** uses a value FortiOS does not accept:

set format rfc6587

`rfc6587` is not a valid value for `set format`. The FortiOS admin guide lists `{default | csv | cef | rfc5424 | json}` for 7.x plus `custom` in 8.0. The CLI rejects it.

RFC 6587 is TCP framing, not a message format, and it is not configurable on the FortiGate: it already applies automatically with `set mode reliable`, which the FortiOS CLI reference defines as "enable reliable syslogging by RFC6587".

The correct value is `set format default`, which is what the pipeline parses. This is worth fixing because users hitting the CLI rejection tend to pick `rfc5424`. With `rfc5424` the FortiGate stops sending `devid`, and since the pipeline renames it to `observer.serial_number` with `ignore_missing: true`, the serial number silently disappears with no error and no tag.

Suggested fix:

set format default

The **Troubleshooting > TCP framing issues** bullet has the same problem: it says both the FortiGate and the integration must have framing set to `rfc6587`, but there is nothing to set on the FortiGate.

### Additional info

_No response_

Contributor guide

No contributing guide indexed for this repository

Research direction

Open the FortiGate integration page at the linked URL and inspect Vendor set up steps > Syslog Configuration > CLI Configuration, then check Troubleshooting > TCP framing issues for the matching guidance. Confirm both sections reflect the FortiOS CLI reference and that the pipeline’s expected format and framing behavior are described consistently.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Active
Clarity
Clearly specified
Newbie friendliness
88/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.