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

observability #1449

Closed
wants to merge 7 commits into from
Closed

observability #1449

wants to merge 7 commits into from

Conversation

mapgirll
Copy link
Contributor

Product Version(s):

Issue:

Link to docs preview:

SME review:

  • An SME has approved this change.

DOCS review:

  • A member of the docs team has approved this change.

Additional information:

Merge checklist:

  • Deploy preview inspected wherever changes were made
  • Build completed successfully
  • Test have passed

Copy link

netlify bot commented Apr 29, 2024

Deploy Preview succeeded!

Built without sensitive environment variables

Name Link
🔨 Latest commit 4100baa
🔍 Latest deploy log https://app.netlify.com/sites/tigera/deploys/663d48f58000b20009701048
😎 Deploy Preview https://deploy-preview-1449--tigera.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 33 (🔴 down 17 from production)
Accessibility: 90 (no change from production)
Best Practices: 83 (no change from production)
SEO: 93 (no change from production)
PWA: -
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify site configuration.

Copy link

netlify bot commented Apr 29, 2024

Deploy Preview for calico-docs-preview-next ready!

Name Link
🔨 Latest commit 4100baa
🔍 Latest deploy log https://app.netlify.com/sites/calico-docs-preview-next/deploys/663d48f57e36790008a7ba6a
😎 Deploy Preview https://deploy-preview-1449--calico-docs-preview-next.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 33 (🔴 down 9 from production)
Accessibility: 90 (no change from production)
Best Practices: 92 (no change from production)
SEO: 86 (no change from production)
PWA: -
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify site configuration.

Copy link
Collaborator

@ctauchen ctauchen left a comment

Choose a reason for hiding this comment

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

A few smallish things for you!


Specific examples of how to use these observability features for these issues can be found below.

### Most-detailed observability
Copy link
Collaborator

Choose a reason for hiding this comment

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

This title reads a bit awkward. I think you should ditch the word 'observability' as you did with the previous titles.

Perhaps something along these lines?

  • Fine-grained log analysis
  • Visualizing logs
  • Observing detailed log output

* *Kibana* - The Kibana dashboards have a "unique-domains" widget that lists the top values of dest_domains from flow logs, with a record count.
Clicking on a domain name in that widget will filter all flows that sent traffic to that FQDN.

To see this in Kibana, watch [this video](https://fast.wistia.com/embed/channel/lhjf79y3oy?wchannelid=lhjf79y3oy&wmediaid=huq9luzvux)
Copy link
Collaborator

Choose a reason for hiding this comment

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

Revisit this anchor text

* *Kibana* - Dashboards and logs in Kibana can be queried using kql to search for flows with specific process ids, names or arguments.
This will return all flows that match, helping to identify the source and destination of flows for those processes.

To view an example using Kibana to filter and identify flows related to log4j communication, watch [this video](https://fast.wistia.com/embed/channel/lhjf79y3oy?wchannelid=lhjf79y3oy&wmediaid=ooka4wvfxz)
Copy link
Collaborator

Choose a reason for hiding this comment

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

Revisit anchor text.

Comment on lines 306 to 308
##### Identify flows with “bytes_in : 0”

Flows with “bytes_in : 0” and “action : allow” indicate that an upstream firewall denied a flow, or the server is not responding to the connection.
Copy link
Collaborator

Choose a reason for hiding this comment

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

For code snippets, please format with backticks:

`bytes_in : 0`


### What is observability?

Observability is the ability to understand the internals of a system by analyzing the internals of a system.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
Observability is the ability to understand the internals of a system by analyzing the internals of a system.
People use observability tools to understand a complex system by visually analyzing what's going on in that system.

A suggestion.

In complex systems, with lots of dynamic, interconnected parts, observability puts a visual frontend on what would otherwise likely be a series of recursive commands in a CLI to obtain the same information.
What that front-end is will depend on the software that’s integrated within the cluster, and will likely depend on which internals are being shown, and who the target audience is.
One example might be a dashboard, showing various metrics to an end-user who needs an overview of a system to monitor it’s health.
Observability could also go more granular than that, representing visually how different resources installed in the cluster are connected and dependent on each other.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
Observability could also go more granular than that, representing visually how different resources installed in the cluster are connected and dependent on each other.
At a more granular level, observability tools can help you visualize how different resources installed in the cluster are connected and dependent on each other.

A suggestion

What that front-end is will depend on the software that’s integrated within the cluster, and will likely depend on which internals are being shown, and who the target audience is.
One example might be a dashboard, showing various metrics to an end-user who needs an overview of a system to monitor it’s health.
Observability could also go more granular than that, representing visually how different resources installed in the cluster are connected and dependent on each other.
In summary, observability is a way to visualize, organize and understand what’s going on in our Kubernetes clusters.
Copy link
Collaborator

Choose a reason for hiding this comment

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

rm

@ctauchen ctauchen mentioned this pull request May 10, 2024
5 tasks
@ctauchen
Copy link
Collaborator

Changes picked up in #1470

@ctauchen ctauchen closed this May 10, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants