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

docs: correct the default collector config apisix actually used for opentelemetry plugin #11247

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

Conversation

flea1lt
Copy link

@flea1lt flea1lt commented May 11, 2024

Description

Fixes #11242

Checklist

  • I have explained the need for this PR and the problem it solves
  • I have explained the changes or the new features added to this PR
  • I have added tests corresponding to this change
  • I have updated the documentation to reflect this change
  • I have verified that this change is backward compatible (If not, please discuss on the APISIX mailing list first)

@flea1lt flea1lt changed the title Fix/opentelemetry docs: opentelemetry May 11, 2024
@flea1lt flea1lt changed the title docs: opentelemetry fix(opentelemetry): correct the default value for the opentelemetry plugin attr and update the docs May 11, 2024
docs/en/latest/plugins/opentelemetry.md Outdated Show resolved Hide resolved
docs/en/latest/plugins/opentelemetry.md Outdated Show resolved Hide resolved
@flea1lt
Copy link
Author

flea1lt commented May 13, 2024

@kayx23 PTAL

kayx23
kayx23 previously approved these changes May 13, 2024
Copy link
Member

@kayx23 kayx23 left a comment

Choose a reason for hiding this comment

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

@shreemaan-abhishek please help review change in conf/config-default.yaml. I have checked that the updated values are indeed the default in the .lua file but have no context for why they were different in the very beginning.

The failing CI is FIPS and doesn't seem relevant.

drop_on_queue_full: false # Drop spans when the export queue is full.
max_queue_size: 1024 # Set the maximum size of the span export queue.
batch_timeout: 2 # Set the timeout for span batches to wait in the export queue before
drop_on_queue_full: true # Drop spans when the export queue is full.
Copy link
Contributor

Choose a reason for hiding this comment

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

I don't understand why these default values need to change.

Copy link
Author

Choose a reason for hiding this comment

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

Because the doc and the values in config-default.yaml are different, we need to align them by updating either the doc or the default config file.

The current apisix doc aligns its values with opentelemetry-lua, which is the dependency used by the plugin. Therefore, it may be preferable to correct the default configuration file.

Copy link
Contributor

Choose a reason for hiding this comment

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

the default values in apisix config file would have been set considering APISIX's use cases. Updating the doc would be better also because existing users might already be relying on the default values, changing them would lead to another effort being required during version upgrade, no?

Copy link
Author

Choose a reason for hiding this comment

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

Well. I will update the doc.

@flea1lt
Copy link
Author

flea1lt commented May 16, 2024

@kayx23 @shreemaan-abhishek PTAL

@flea1lt flea1lt changed the title fix(opentelemetry): correct the default value for the opentelemetry plugin attr and update the docs docs: correct the default collector config apisix actually used for opentelemetry plugin May 16, 2024
@yzeng25 yzeng25 requested a review from kayx23 May 17, 2024 05:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
3 participants