Skip to content

docs: pypi-installation on Ubuntu 24.04 and statsd package for event-logging #32891

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

Open
wants to merge 3 commits into
base: master
Choose a base branch
from

Conversation

125m125
Copy link

@125m125 125m125 commented Mar 28, 2025

SUMMARY

  • Adds Ubuntu 24.04 and the need for an older python version to the pypi installation instructions.
  • Adds note that the statsd-package needs to be installed for the StatsdStatsLogger and how to inspect errors
    • Suggestion: Maybe instead of suppressing the exception, superset could be adjusted to still create the StatsdStatsLogger class but it throws the caught exception on init so the users can see the actual problem?
try:
    from statsd import StatsClient
    ...
except Exception as e:  # pylint: disable=broad-except
    class StatsdStatsLogger(BaseStatsLogger):
        def __init__(  # pylint: disable=super-init-not-called
            self,
            host: str = "localhost",
            port: int = 8125,
            prefix: str = "superset",
            statsd_client: Optional[StatsClient] = None,
        ) -> None:
            raise e

BEFORE/AFTER SCREENSHOTS OR ANIMATED GIF

TESTING INSTRUCTIONS

ADDITIONAL INFORMATION

  • Has associated issue:
  • Required feature flags:
  • Changes UI
  • Includes DB Migration (follow approval process in SIP-59)
    • Migration is atomic, supports rollback & is backwards-compatible
    • Confirm DB migration upgrade and downgrade tested
    • Runtime estimates and downtime expectations provided
  • Introduces new feature or API
  • Removes existing feature or API

Copy link

@korbit-ai korbit-ai bot left a comment

Choose a reason for hiding this comment

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

I've completed my review and didn't find any issues.

Need a new review? Comment /korbit-review on this PR and I'll review your latest changes.

Korbit Guide: Usage and Customization

Interacting with Korbit

  • You can manually ask Korbit to review your PR using the /korbit-review command in a comment at the root of your PR.
  • You can ask Korbit to generate a new PR description using the /korbit-generate-pr-description command in any comment on your PR.
  • Too many Korbit comments? I can resolve all my comment threads if you use the /korbit-resolve command in any comment on your PR.
  • On any given comment that Korbit raises on your pull request, you can have a discussion with Korbit by replying to the comment.
  • Help train Korbit to improve your reviews by giving a 👍 or 👎 on the comments Korbit posts.

Customizing Korbit

  • Check out our docs on how you can make Korbit work best for you and your team.
  • Customize Korbit for your organization through the Korbit Console.

Current Korbit Configuration

General Settings
Setting Value
Review Schedule Automatic excluding drafts
Max Issue Count 10
Automatic PR Descriptions
Issue Categories
Category Enabled
Documentation
Logging
Error Handling
Readability
Design
Performance
Security
Functionality

Feedback and Support

Note

Korbit Pro is free for open source projects 🎉

Looking to add Korbit to your team? Get started with a free 2 week trial here

@github-actions github-actions bot added the doc Namespace | Anything related to documentation label Mar 28, 2025
Copy link
Contributor

@github-actions github-actions bot left a comment

Choose a reason for hiding this comment

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

Congrats on making your first PR and thank you for contributing to Superset! 🎉 ❤️

We hope to see you in our Slack community too! Not signed up? Use our Slack App to self-register.


```python
from superset.stats_logger import StatsdStatsLogger
STATS_LOGGER = StatsdStatsLogger(host='localhost', port=8125, prefix='superset')
```

If you get the Error `ImportError: cannot import name 'StatsdStatsLogger' from 'superset.stats_logger' (/path/to/superset/env/superset/stats_logger.py)`, you can edit the `except Exception` block to print error details:
Copy link
Member

Choose a reason for hiding this comment

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

What file is being edited here? It's unclear to me, sorry.

@@ -51,11 +51,24 @@ if desired. Most endpoints hit are logged as
well as key events like query start and end in SQL Lab.

To setup StatsD logging, it’s a matter of configuring the logger in your `superset_config.py`.
If not already present, you need to ensure that the `statsd`-package is installed in superset's python environment.
Copy link
Member

Choose a reason for hiding this comment

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

Nitpick: could you capitalize Superset throughout?

Copy link
Member

@sfirke sfirke left a comment

Choose a reason for hiding this comment

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

I have two tiny things (capitalize Superset and clarify what file to edit) but this LGTM. @125m125 do you want to make those tweaks? That would be ideal but if it gets stale I'll just merge it.

@sfirke
Copy link
Member

sfirke commented Apr 1, 2025

Suggestion: Maybe instead of suppressing the exception, superset could be adjusted to still create the StatsdStatsLogger class but it throws the caught exception on init so the users can see the actual problem?

@125m125 this is fine with me. Would you like to do that on a separate PR after this merges, or add it to this PR (in which case would you take out the docs about modifying the logger function) ?

@125m125
Copy link
Author

125m125 commented Apr 1, 2025

@sfirke Thank you for the feedback, I have capitalized Superset and implemented the error-handling suggestion. I have done it in two commits in case you prefer the error handling to be a separate PR, since it isn't only documentation anymore.
I only tested the change manually. I don't know if it is possible to add automatic test for the changes, since the exception should only occur when the statsd-package is missing.

Copy link

codecov bot commented Apr 2, 2025

Codecov Report

Attention: Patch coverage is 16.66667% with 5 lines in your changes missing coverage. Please review.

Project coverage is 83.38%. Comparing base (76d897e) to head (ca6b8a1).
Report is 1712 commits behind head on master.

Files with missing lines Patch % Lines
superset/stats_logger.py 16.66% 5 Missing ⚠️
Additional details and impacted files
@@             Coverage Diff             @@
##           master   #32891       +/-   ##
===========================================
+ Coverage   60.48%   83.38%   +22.89%     
===========================================
  Files        1931      550     -1381     
  Lines       76236    39510    -36726     
  Branches     8568        0     -8568     
===========================================
- Hits        46114    32946    -13168     
+ Misses      28017     6564    -21453     
+ Partials     2105        0     -2105     
Flag Coverage Δ
hive 48.37% <16.66%> (-0.79%) ⬇️
javascript ?
mysql 75.60% <16.66%> (?)
postgres 75.67% <16.66%> (?)
presto 52.89% <16.66%> (-0.91%) ⬇️
python 83.38% <16.66%> (+19.88%) ⬆️
sqlite 75.17% <16.66%> (?)
unit 61.43% <16.66%> (+3.80%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
doc Namespace | Anything related to documentation size/M
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants