Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[DOC] Add firewall as possible troubleshooting issue #21743

Merged
merged 6 commits into from
Oct 21, 2020

Conversation

lucabelluccini
Copy link
Contributor

@lucabelluccini lucabelluccini commented Oct 13, 2020

In case a firewall closes long persistent connections between Beats & Logstash, errors such as write tcp ... write: connection reset by peer will be reported by a given Beat.
This documentation page should be useful to identify this kind of issues.

What does this PR do?

Add documentation for troubleshooting Beats to LS connections

Reviewer Checklist

  • Please review the asciidoc format (I would like to link the Logstash ttl setting)
  • Please backport this change to all Beats & versions

In case a firewall closes long persistent connections between Beats & Logstash, errors such as `write tcp ... write: connection reset by peer` will be reported by a given Beat.
This documentation page should be useful to identify this kind of issues.
@botelastic botelastic bot added the needs_team Indicates that the issue/PR needs a Team:* label label Oct 13, 2020
@lucabelluccini lucabelluccini added docs Team:Docs Label for the Observability docs team labels Oct 13, 2020
@elasticmachine
Copy link
Collaborator

Pinging @elastic/obs-docs (Team:Docs)

@botelastic botelastic bot removed the needs_team Indicates that the issue/PR needs a Team:* label label Oct 13, 2020
@elasticmachine
Copy link
Collaborator

elasticmachine commented Oct 13, 2020

💚 Build Succeeded

the below badges are clickable and redirect to their specific view in the CI or DOCS
Pipeline View Test View Changes Artifacts preview

Expand to view the summary

Build stats

  • Build Cause: [Pull request #21743 updated]

  • Start Time: 2020-10-17T01:15:48.440+0000

  • Duration: 25 min 40 sec

@fbaligand
Copy link

@lucabelluccini
You have also to set "pipelining: 0".
Else ttl setting is not effective (as documented)

@lucabelluccini
Copy link
Contributor Author

Thank you @fbaligand - The first objective is to also add a link the Logstash output documentation.
The incompatibility with pipelining might change in the future, but you're right - it's worth mentioning at the moment.

@fbaligand
Copy link

Nice ! 👍

Copy link
Contributor

@dedemorton dedemorton left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested a few edits.

Thanks for contributing this!

libbeat/docs/shared-faq.asciidoc Outdated Show resolved Hide resolved
libbeat/docs/shared-faq.asciidoc Outdated Show resolved Hide resolved
libbeat/docs/shared-faq.asciidoc Outdated Show resolved Hide resolved
libbeat/docs/shared-faq.asciidoc Outdated Show resolved Hide resolved
lucabelluccini and others added 3 commits October 16, 2020 09:34
Co-authored-by: DeDe Morton <dede.morton@elastic.co>
Co-authored-by: DeDe Morton <dede.morton@elastic.co>
Co-authored-by: DeDe Morton <dede.morton@elastic.co>
Co-authored-by: Luca Belluccini <luca.belluccini@elastic.co>
Copy link
Contributor

@dedemorton dedemorton left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM. Thanks again for submitting this!

@lucabelluccini
Copy link
Contributor Author

Thank you for the review and suggestions! I would ask if it possible to backport it.

@dedemorton
Copy link
Contributor

dedemorton commented Oct 19, 2020

@lucabelluccini Yes! I can backport it. Just let me know which versions you want it in. Typically, we'll go back one version unless it's a critical fix. The CI tends to fail on the older branches. Hit Squash and merge if you're ready!

@dedemorton
Copy link
Contributor

Hope you don't mind, but I'm going to merge this to get it off my to-do list. If you have any problems with the changes, we can do a follow-up PR.

@dedemorton dedemorton merged commit 5935293 into master Oct 21, 2020
@dedemorton dedemorton deleted the doc-firewall-disconnections-logstash branch October 21, 2020 00:22
dedemorton added a commit to dedemorton/beats that referenced this pull request Oct 21, 2020
* [DOC] Add firewall as possible troubleshooting issue

In case a firewall closes long persistent connections between Beats & Logstash, errors such as `write tcp ... write: connection reset by peer` will be reported by a given Beat.
This documentation page should be useful to identify this kind of issues.

* Update shared-faq.asciidoc

Amend

* Update libbeat/docs/shared-faq.asciidoc

Co-authored-by: DeDe Morton <dede.morton@elastic.co>

* Update libbeat/docs/shared-faq.asciidoc

Co-authored-by: DeDe Morton <dede.morton@elastic.co>

* Update libbeat/docs/shared-faq.asciidoc

Co-authored-by: DeDe Morton <dede.morton@elastic.co>

* Make title more descriptive

Co-authored-by: Luca Belluccini <luca.belluccini@elastic.co>

Co-authored-by: DeDe Morton <dede.morton@elastic.co>
dedemorton added a commit to dedemorton/beats that referenced this pull request Oct 21, 2020
* [DOC] Add firewall as possible troubleshooting issue

In case a firewall closes long persistent connections between Beats & Logstash, errors such as `write tcp ... write: connection reset by peer` will be reported by a given Beat.
This documentation page should be useful to identify this kind of issues.

* Update shared-faq.asciidoc

Amend

* Update libbeat/docs/shared-faq.asciidoc

Co-authored-by: DeDe Morton <dede.morton@elastic.co>

* Update libbeat/docs/shared-faq.asciidoc

Co-authored-by: DeDe Morton <dede.morton@elastic.co>

* Update libbeat/docs/shared-faq.asciidoc

Co-authored-by: DeDe Morton <dede.morton@elastic.co>

* Make title more descriptive

Co-authored-by: Luca Belluccini <luca.belluccini@elastic.co>

Co-authored-by: DeDe Morton <dede.morton@elastic.co>
dedemorton added a commit to dedemorton/beats that referenced this pull request Oct 21, 2020
* [DOC] Add firewall as possible troubleshooting issue

In case a firewall closes long persistent connections between Beats & Logstash, errors such as `write tcp ... write: connection reset by peer` will be reported by a given Beat.
This documentation page should be useful to identify this kind of issues.

* Update shared-faq.asciidoc

Amend

* Update libbeat/docs/shared-faq.asciidoc

Co-authored-by: DeDe Morton <dede.morton@elastic.co>

* Update libbeat/docs/shared-faq.asciidoc

Co-authored-by: DeDe Morton <dede.morton@elastic.co>

* Update libbeat/docs/shared-faq.asciidoc

Co-authored-by: DeDe Morton <dede.morton@elastic.co>

* Make title more descriptive

Co-authored-by: Luca Belluccini <luca.belluccini@elastic.co>

Co-authored-by: DeDe Morton <dede.morton@elastic.co>
dedemorton added a commit that referenced this pull request Oct 21, 2020
* [DOC] Add firewall as possible troubleshooting issue

In case a firewall closes long persistent connections between Beats & Logstash, errors such as `write tcp ... write: connection reset by peer` will be reported by a given Beat.
This documentation page should be useful to identify this kind of issues.

* Update shared-faq.asciidoc

Amend

* Update libbeat/docs/shared-faq.asciidoc

Co-authored-by: DeDe Morton <dede.morton@elastic.co>

* Update libbeat/docs/shared-faq.asciidoc

Co-authored-by: DeDe Morton <dede.morton@elastic.co>

* Update libbeat/docs/shared-faq.asciidoc

Co-authored-by: DeDe Morton <dede.morton@elastic.co>

* Make title more descriptive

Co-authored-by: Luca Belluccini <luca.belluccini@elastic.co>

Co-authored-by: DeDe Morton <dede.morton@elastic.co>

Co-authored-by: Luca Belluccini <luca.belluccini@elastic.co>
dedemorton added a commit that referenced this pull request Oct 21, 2020
* [DOC] Add firewall as possible troubleshooting issue

In case a firewall closes long persistent connections between Beats & Logstash, errors such as `write tcp ... write: connection reset by peer` will be reported by a given Beat.
This documentation page should be useful to identify this kind of issues.

* Update shared-faq.asciidoc

Amend

* Update libbeat/docs/shared-faq.asciidoc

Co-authored-by: DeDe Morton <dede.morton@elastic.co>

* Update libbeat/docs/shared-faq.asciidoc

Co-authored-by: DeDe Morton <dede.morton@elastic.co>

* Update libbeat/docs/shared-faq.asciidoc

Co-authored-by: DeDe Morton <dede.morton@elastic.co>

* Make title more descriptive

Co-authored-by: Luca Belluccini <luca.belluccini@elastic.co>

Co-authored-by: DeDe Morton <dede.morton@elastic.co>

Co-authored-by: Luca Belluccini <luca.belluccini@elastic.co>
dedemorton added a commit that referenced this pull request Oct 21, 2020
* [DOC] Add firewall as possible troubleshooting issue

In case a firewall closes long persistent connections between Beats & Logstash, errors such as `write tcp ... write: connection reset by peer` will be reported by a given Beat.
This documentation page should be useful to identify this kind of issues.

* Update shared-faq.asciidoc

Amend

* Update libbeat/docs/shared-faq.asciidoc

Co-authored-by: DeDe Morton <dede.morton@elastic.co>

* Update libbeat/docs/shared-faq.asciidoc

Co-authored-by: DeDe Morton <dede.morton@elastic.co>

* Update libbeat/docs/shared-faq.asciidoc

Co-authored-by: DeDe Morton <dede.morton@elastic.co>

* Make title more descriptive

Co-authored-by: Luca Belluccini <luca.belluccini@elastic.co>

Co-authored-by: DeDe Morton <dede.morton@elastic.co>

Co-authored-by: Luca Belluccini <luca.belluccini@elastic.co>
v1v added a commit to v1v/beats that referenced this pull request Oct 21, 2020
…ter-commit

* upstream/master:
  feat: package aliases for snapshots (elastic#21960)
  [DOC] Add firewall as possible troubleshooting issue (elastic#21743)
  [Filebeat] Add max_number_of_messages config parameter for S3 input (elastic#21993)
  [Elastic Agent] Fix missing elastic_agent event data  (elastic#21994)
  Document auditbeat system process module config (elastic#21766)
  Update links (elastic#22012)
v1v added a commit to v1v/beats that referenced this pull request Oct 21, 2020
* upstream/master:
  feat: package aliases for snapshots (elastic#21960)
  [DOC] Add firewall as possible troubleshooting issue (elastic#21743)
  [Filebeat] Add max_number_of_messages config parameter for S3 input (elastic#21993)
  [Elastic Agent] Fix missing elastic_agent event data  (elastic#21994)
  Document auditbeat system process module config (elastic#21766)
  Update links (elastic#22012)
  dynamically find librpm (elastic#21936)
  Fix Istio docs (elastic#22019)
  [beats-tester][packaging] store packages in another location (elastic#21903)
  [Kubernetes] Remove redundant dockersock volume mount (elastic#22009)
  [Ingest Manager] Always try snapshot repo for agent upgrade (elastic#21951)
  Azure storage metricset values not inside the metricset name (elastic#21845)
  fix diskio and memory bugs under windows (elastic#21992)
  Fix TestDockerStart flaky test (elastic#21681)
  filebeat: add SSL options to checkpoint module (elastic#19560)
  Stop storing stateless kubernetes keystores (elastic#21880)
  [Elastic Agent] Fix named pipe communication on Windows 7 (elastic#21931)
  [Elastic Agent] Fix index for Agent monitoring to to elastic_agent. (elastic#21932)
v1v added a commit to v1v/beats that referenced this pull request Oct 22, 2020
* upstream/master: (27 commits)
  chore: use ubuntu 18 as linux agent (elastic#22084)
  docs: Prepare Changelog for 7.9.3 (elastic#22073) (elastic#22075)
  docs: Prepare Changelog for 6.8.13 (elastic#22072) (elastic#22079)
  [build][packaging] Add resilience when docker build (elastic#22050)
  Fix the url of reviewdog (elastic#21981)
  revert WSS process reporting for windows (elastic#22055)
  Fix typo (elastic#19585) (elastic#22061)
  [Ingest Manager] Use ML_SYSTEM to detect if agent is running as a service (elastic#21884)
  Prevent log input from sending duplicate messages due to file renaming (elastic#21911)
  feat: package aliases for snapshots (elastic#21960)
  [DOC] Add firewall as possible troubleshooting issue (elastic#21743)
  [Filebeat] Add max_number_of_messages config parameter for S3 input (elastic#21993)
  [Elastic Agent] Fix missing elastic_agent event data  (elastic#21994)
  Document auditbeat system process module config (elastic#21766)
  Update links (elastic#22012)
  dynamically find librpm (elastic#21936)
  Fix Istio docs (elastic#22019)
  [beats-tester][packaging] store packages in another location (elastic#21903)
  [Kubernetes] Remove redundant dockersock volume mount (elastic#22009)
  [Ingest Manager] Always try snapshot repo for agent upgrade (elastic#21951)
  ...
leweafan pushed a commit to leweafan/beats that referenced this pull request Apr 28, 2023
…lastic#22040)

* [DOC] Add firewall as possible troubleshooting issue

In case a firewall closes long persistent connections between Beats & Logstash, errors such as `write tcp ... write: connection reset by peer` will be reported by a given Beat.
This documentation page should be useful to identify this kind of issues.

* Update shared-faq.asciidoc

Amend

* Update libbeat/docs/shared-faq.asciidoc

Co-authored-by: DeDe Morton <dede.morton@elastic.co>

* Update libbeat/docs/shared-faq.asciidoc

Co-authored-by: DeDe Morton <dede.morton@elastic.co>

* Update libbeat/docs/shared-faq.asciidoc

Co-authored-by: DeDe Morton <dede.morton@elastic.co>

* Make title more descriptive

Co-authored-by: Luca Belluccini <luca.belluccini@elastic.co>

Co-authored-by: DeDe Morton <dede.morton@elastic.co>

Co-authored-by: Luca Belluccini <luca.belluccini@elastic.co>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Team:Docs Label for the Observability docs team
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants