using send-envelope error with types invalid type: boolean `false`, expected a string

[reuvenstr]

CLI Version

sentry-cli 2.45.0

Operating System and Architecture

• macOS (arm64)
• macOS (x86_64)
• Linux (i686)
• Linux (x86_64)
• Linux (armv7)
• Linux (aarch64)
• Windows (i686)
• Windows (x86_64)

Operating System Version

ubuntu 22.04

Link to reproduction repository

No response

CLI Command

sentry-cli send-envelope 20250514055208474932.json

Exact Reproduction Steps

I used customhttp that replaces the default one, and saved in with envelope.serialize_into into file, not all files are affected
Just save this to a json file and replace PUBLIC_KEY in it, then run cli command to get the error

{"event_id":"1b572e2d5b7344c485ad0a4a2c8714d5","sent_at":"2025-05-14T06:24:50.259499Z","trace":{"trace_id":"3ca5433f17cf451b89b907cc436c7ecd","environment":"staging","public_key":"PUBLIC_KEY","transaction":"a","sample_rate":"0.5","sampled":"true"}}
{"type":"transaction","content_type":"application/json","length":2150}
{"type":"transaction","transaction":"a","transaction_info":{"source":"component"},"contexts":{"response":{"status_code":200},"trace":{"trace_id":"3ca5433f17cf451b89b907cc436c7ecd","span_id":"bb2e53ef0b9acc57","parent_span_id":null,"op":"http.server","description":null,"origin":"auto.http.flask","status":"ok","data":{"thread.id":"139648280012352","thread.name":"ThreadPoolExecutor-0_0","http.response.status_code":200}},"runtime":{"name":"CPython","version":"3.10.12","build":"3.10.12 (main, Feb  4 2025, 14:57:36) [GCC 11.4.0]"}},"tags":{"http.status_code":"200"},"timestamp":"2025-05-14T06:24:50.257227Z","start_timestamp":"2025-05-14T06:24:50.089881Z","spans":[{"trace_id":"3ca5433f17cf451b89b907cc436c7ecd","span_id":"afe047658d30db29","parent_span_id":"bb2e53ef0b9acc57","same_process_as_parent":true,"op":"db.redis","description":"-","tags":{"redis.is_cluster":false,"redis.command":"GET","db.operation":"GET","redis.key":"-"},"data":{"thread.id":"139648280012352","thread.name":"ThreadPoolExecutor-0_0","db.system":"redis","db.name":"1","server.address":"localhost","server.port":2131}}],"measurements":{},"event_id":"1b572e2d5b7344c485ad0a4a2c8714d5","extra":{"sys.argv":["python3","test.py"]},"request":{"url":"http://127.0.0.1/a","method":"GET"},"headers":{"Content-Type":"application/json","Content-Length":"2","X-Forwarded-For":"","X-Forwarded-Proto":"https","Host":"127.0.0.1","User-Agent":"python-requests/2.31.0","Accept-Encoding":"gzip, deflate","Accept":"*/*","Authorization":"[Filtered]"},"data":{}},"environment":"-","server_name":"-","sdk":{"name":"sentry.python.flask","version":"2.12.0","packages":[{"name":"pypi:sentry-sdk","version":"2.12.0"}],"integrations":["aiohttp","argv","asyncpg","atexit","dedupe","excepthook","flask","logging","loguru","modules","pymongo","redis","sqlalchemy","stdlib","threading"]},"platform":"python","_meta":{"spans":{"0":{"tags":{"redis.key":{"":{"len":1184,"rem":[["!limit","x",1021,1024]]}}}},"9":{"tags":{"redis.key":{"":{"len":1184,"rem":[["!limit","x",1021,1024]]}}}}},"request":{"headers":{"X-Forwarded-For":{"":{"rem":[["!config","x"]]}},"Authorization":{"":{"rem":[["!config","s"]]}}}}}}

Expected Results

Don't fail when sending an envelope

Actual Results

fails to send

Logs

  DEBUG   2025-05-14 06:46:24.383406293 +00:00 sentry-cli version: 2.45.0, platform: "linux", architecture: "x86_64"
  INFO    2025-05-14 06:46:24.384535307 +00:00 sentry-cli was invoked with the following command line: "sentry-cli" "send-envelope" "20250514062450284788.json" "--log-level=debug"
error: invalid item payload

Caused by:
    invalid type: boolean `false`, expected a string at line 1 column 873
  INFO    2025-05-14 06:46:24.385035328 +00:00 Skipping update nagger update check

[szokeasaurusrex]

Hi @reuvenstr, I do not know how you generated this envelope because I am unsure what you mean by using "customhttp that replaces the default one."

However, this envelope is indeed invalid. There appear to be multiple problems with it; one of them is that the tags dictionary contains a boolean value (false), even though tag values must be strings. So, this error is expected behavior in the Sentry CLI. If there is a bug, the bug is in the service which generated this envelope.

The only problem I see here is that the line number listed in the error message is incorrect; the error says the invalid value is on line 1, but it is actually line 3 (column is correct). But, I will make a separate issue for fixing this problem.

[reuvenstr]

Hi @reuvenstr, I do not know how you generated this envelope because I am unsure what you mean by using "customhttp that replaces the default one."

However, this envelope is indeed invalid. There appear to be multiple problems with it; one of them is that the tags dictionary contains a boolean value (false), even though tag values must be strings. So, this error is expected behavior in the Sentry CLI. If there is a bug, the bug is in the service which generated this envelope.

The only problem I see here is that the line number listed in the error message is incorrect; the error says the invalid value is on line 1, but it is actually line 3 (column is correct). But, I will make a separate issue for fixing this problem.

Thanks for fast reply 🥇
I have such a thing

 class CustomHttpTransport(sentry_sdk.HttpTransport):
            def __init__(self, options: dict[str, Any]) -> None:
                super().__init__(options=options)

            def capture_envelope(self, envelope: Envelope) -> None:
                 self.collect_locally(envelope)
                 super().capture_envelope(envelope=envelope)

            def collect_locally(self, envelope: Envelope) -> None:
                with open("/tmp/blabla", "wb") as f:
                    envelope.serialize_into(f)

And for some services it fails, but it doesn't fail with regular super().capture_envelope(envelope=envelope), that's why I thought that issue is related to cli..

[szokeasaurusrex]

Yeah, most likely the serialization logic in the Python SDK has a bug, and it is saving the tags in a non-string format. I also help with maintaining the Python SDK, so I can investigate a bit further and open an issue to apply the fix in the Python SDK if needed

[szokeasaurusrex]

Also, just out of curiosity, what are trying to accomplish with this setup? Is there some higher-level problem that you have encountered?

[reuvenstr]

Also, just out of curiosity, what are trying to accomplish with this setup? Is there some higher-level problem that you have encountered?

I have some air gapped environment, but logs can be extracted for there. So I thought about saving envelopes on disk, and upload them to sentry from time to time

[szokeasaurusrex]

Okay, got it. Looks like the Python SDK does not enforce that tags have string values. Likely the Python SDK's transport supports sending envelopes with non-string tag values, which is why this behavior is not a problem for most folks, but it is still a bug in the Python SDK because if the envelope is serialized, the serialized envelope does not comply with our specs for a valid envelope and thus may not be accepted by all of our other tools (in particular, in this case, the CLI)