Skip to content

[docs] Update docs guidelines to include supported inputs for each integration #3628

@colleenmcginnis

Description

@colleenmcginnis

In #3433, @jamiehynds suggested:

It may also be worth calling out which inputs are supported by the integration. This come up occasionally with users - they have to go to the integration and manually determine which inputs are support. e.g. for some integrations users can ingest logs via API, S3 or log file.

Input types can be found in the manifest.yml for each integration. However, it's still not clear to me what the one-to-one comparison of the inputs you can find in the manifest.yml align with the inputs listed in the Filebeat docs referenced in #3433 (comment).

I don't know if I'm overthinking this, but (for example) I see four inputs for the System integration:

image

Based on Jamie's comment from the PR I would guess...

...but I don't know how to reference winlog and system/metrics.

As next steps, maybe we can:

  • Work together separately to develop a one-to-one comparison of inputs to the relevant reference docs
  • Update the documentation guidelines to explain how to document inputs in READMEs
  • Update all docs that have already been reworked to follow the new guidelines

cc @elastic/obs-docs

Metadata

Metadata

Assignees

No one assigned

    Labels

    StalledTeam:DocsLabel for the Observability docs teamdocumentationImprovements or additions to documentation. Applied to PRs that modify *.md files.enhancementNew feature or request

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions