|
| 1 | +from unittest import mock |
| 2 | + |
| 3 | +import sentry_sdk |
| 4 | +from sentry_sdk.consts import OP |
| 5 | + |
| 6 | + |
| 7 | +def test_breadcrumbs(sentry_init, capture_events): |
| 8 | + """ |
| 9 | + This test illustrates how breadcrumbs are added to the error event when an error occurs |
| 10 | + """ |
| 11 | + sentry_init( |
| 12 | + traces_sample_rate=1.0, |
| 13 | + ) |
| 14 | + events = capture_events() |
| 15 | + |
| 16 | + add_breadcrumbs_kwargs = { |
| 17 | + "type": "navigation", |
| 18 | + "category": "unit_tests.breadcrumbs", |
| 19 | + "level": "fatal", |
| 20 | + "origin": "unit-tests", |
| 21 | + "data": { |
| 22 | + "string": "foobar", |
| 23 | + "number": 4.2, |
| 24 | + "array": [1, 2, 3], |
| 25 | + "dict": {"foo": "bar"}, |
| 26 | + }, |
| 27 | + } |
| 28 | + |
| 29 | + with sentry_sdk.start_transaction(name="trx-breadcrumbs"): |
| 30 | + sentry_sdk.add_breadcrumb(message="breadcrumb0", **add_breadcrumbs_kwargs) |
| 31 | + |
| 32 | + with sentry_sdk.start_span(name="span1", op="function"): |
| 33 | + sentry_sdk.add_breadcrumb(message="breadcrumb1", **add_breadcrumbs_kwargs) |
| 34 | + |
| 35 | + with sentry_sdk.start_span(name="span2", op="function"): |
| 36 | + sentry_sdk.add_breadcrumb( |
| 37 | + message="breadcrumb2", **add_breadcrumbs_kwargs |
| 38 | + ) |
| 39 | + |
| 40 | + # Spans that create breadcrumbs automatically |
| 41 | + with sentry_sdk.start_span(name="span3", op=OP.DB_REDIS) as span3: |
| 42 | + span3.set_data("span3_data", "data on the redis span") |
| 43 | + span3.set_tag("span3_tag", "tag on the redis span") |
| 44 | + |
| 45 | + with sentry_sdk.start_span(name="span4", op=OP.HTTP_CLIENT) as span4: |
| 46 | + span4.set_data("span4_data", "data on the http.client span") |
| 47 | + span4.set_tag("span4_tag", "tag on the http.client span") |
| 48 | + |
| 49 | + with sentry_sdk.start_span(name="span5", op=OP.SUBPROCESS) as span5: |
| 50 | + span5.set_data("span5_data", "data on the subprocess span") |
| 51 | + span5.set_tag("span5_tag", "tag on the subprocess span") |
| 52 | + |
| 53 | + with sentry_sdk.start_span(name="span6", op="function") as span6: |
| 54 | + # This data on the span is not added to custom breadcrumbs. |
| 55 | + # Data from the span is only added to automatic breadcrumbs shown above |
| 56 | + span6.set_data("span6_data", "data on span6") |
| 57 | + span6.set_tag("span6_tag", "tag on the span6") |
| 58 | + sentry_sdk.add_breadcrumb( |
| 59 | + message="breadcrumb6", **add_breadcrumbs_kwargs |
| 60 | + ) |
| 61 | + |
| 62 | + try: |
| 63 | + 1 / 0 |
| 64 | + except ZeroDivisionError as ex: |
| 65 | + sentry_sdk.capture_exception(ex) |
| 66 | + |
| 67 | + (error,) = events |
| 68 | + |
| 69 | + breadcrumbs = error["breadcrumbs"]["values"] |
| 70 | + |
| 71 | + for crumb in breadcrumbs: |
| 72 | + print(crumb) |
| 73 | + |
| 74 | + assert len(breadcrumbs) == 7 |
| 75 | + |
| 76 | + # Check for my custom breadcrumbs |
| 77 | + for i in range(0, 3): |
| 78 | + assert breadcrumbs[i]["message"] == f"breadcrumb{i}" |
| 79 | + assert breadcrumbs[i]["type"] == "navigation" |
| 80 | + assert breadcrumbs[i]["category"] == "unit_tests.breadcrumbs" |
| 81 | + assert breadcrumbs[i]["level"] == "fatal" |
| 82 | + assert breadcrumbs[i]["origin"] == "unit-tests" |
| 83 | + assert breadcrumbs[i]["data"] == { |
| 84 | + "string": "foobar", |
| 85 | + "number": 4.2, |
| 86 | + "array": [1, 2, 3], |
| 87 | + "dict": {"foo": "bar"}, |
| 88 | + } |
| 89 | + assert breadcrumbs[i]["timestamp"] == mock.ANY |
| 90 | + |
| 91 | + # Check automatic redis breadcrumbs |
| 92 | + assert breadcrumbs[3]["message"] == "span3" |
| 93 | + assert breadcrumbs[3]["type"] == "redis" |
| 94 | + assert breadcrumbs[3]["category"] == "redis" |
| 95 | + assert "level" not in breadcrumbs[3] |
| 96 | + assert "origin" not in breadcrumbs[3] |
| 97 | + assert breadcrumbs[3]["data"] == { |
| 98 | + "span3_tag": "tag on the redis span", |
| 99 | + } |
| 100 | + assert breadcrumbs[3]["timestamp"] == mock.ANY |
| 101 | + |
| 102 | + # Check automatic http.client breadcrumbs |
| 103 | + assert "message" not in breadcrumbs[4] |
| 104 | + assert breadcrumbs[4]["type"] == "http" |
| 105 | + assert breadcrumbs[4]["category"] == "httplib" |
| 106 | + assert "level" not in breadcrumbs[4] |
| 107 | + assert "origin" not in breadcrumbs[4] |
| 108 | + assert breadcrumbs[4]["data"] == { |
| 109 | + "thread.id": mock.ANY, |
| 110 | + "thread.name": mock.ANY, |
| 111 | + "span4_data": "data on the http.client span", |
| 112 | + } |
| 113 | + assert breadcrumbs[4]["timestamp"] == mock.ANY |
| 114 | + |
| 115 | + # Check automatic subprocess breadcrumbs |
| 116 | + assert breadcrumbs[5]["message"] == "span5" |
| 117 | + assert breadcrumbs[5]["type"] == "subprocess" |
| 11
1241
8 | + assert breadcrumbs[5]["category"] == "subprocess" |
| 119 | + assert "level" not in breadcrumbs[5] |
| 120 | + assert "origin" not in breadcrumbs[5] |
| 121 | + assert breadcrumbs[5]["data"] == { |
| 122 | + "thread.id": mock.ANY, |
| 123 | + "thread.name": mock.ANY, |
| 124 | + "span5_data": "data on the subprocess span", |
| 125 | + } |
| 126 | + assert breadcrumbs[5]["timestamp"] == mock.ANY |
| 127 | + |
| 128 | + # Check for custom breadcrumbs on span6 |
| 129 | + assert breadcrumbs[6]["message"] == "breadcrumb6" |
| 130 | + assert breadcrumbs[6]["type"] == "navigation" |
| 131 | + assert breadcrumbs[6]["category"] == "unit_tests.breadcrumbs" |
| 132 | + assert breadcrumbs[6]["level"] == "fatal" |
| 133 | + assert breadcrumbs[6]["origin"] == "unit-tests" |
| 134 | + assert breadcrumbs[6]["data"] == { |
| 135 | + "string": "foobar", |
| 136 | + "number": 4.2, |
| 137 | + "array": [1, 2, 3], |
| 138 | + "dict": {"foo": "bar"}, |
| 139 | + } |
| 140 | + assert breadcrumbs[6]["timestamp"] == mock.ANY |
0 commit comments