Skip to content

Conversation

@zxzinn
Copy link

@zxzinn zxzinn commented Dec 13, 2025

Which problem is this PR solving?

When connecting the gRPC exporter to a local OTLP collector (e.g., Phoenix, Jaeger) without TLS, developers encounter errors like:

14 UNAVAILABLE: No connection established.
Last error: SSL routines:ssl3_get_record:wrong version number

The README states "By default, plaintext connection is used" (line 47), which is outdated since v0.29.0. The exporter now defaults to secure connections, but there's no clear guidance on using insecure connections for local development.

Short description of the changes

  • Fixes outdated default behavior description
  • Adds two complete examples for insecure connections:
    • Using http:// URL scheme (recommended, simpler)
    • Using explicit credentials.createInsecure() (alternative)
  • Examples follow existing README style with full working code

Type of change

  • Bug fix (non-breaking change which fixes an issue)
  • This change requires a documentation update

Checklist:

  • Followed the style guidelines of this project
  • Documentation has been updated

- Clarify that secure (TLS) connection is used by default
- Add example showing http:// scheme for insecure connections
- Add example with explicit insecure credentials configuration
- Update documentation to better guide local development setup
@zxzinn zxzinn requested a review from a team as a code owner December 13, 2025 14:44
@linux-foundation-easycla
Copy link

linux-foundation-easycla bot commented Dec 13, 2025

CLA Signed
The committers listed above are authorized under a signed CLA.

  • ✅ login: zxzinn / name: zxzinn (7d2f2e2)

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.

1 participant