Files
openobserve/tests/api-testing/tests/ingest/test_logs.py
T
Shrinath RaoandClaude Opus 4.7 61aa772d57 test: revamp api-testing suite (framework + 16 file rewrites + CI matrix) (#12372)
## Summary

Comprehensive rework of the `tests/api-testing/` suite. 30+ commits
implementing all 6 phases of the [revamp
plan](../../tests/ui-testing/MD_Files/api%20tests%20revamp/API_TESTS_REVAMP.md).

**Before → After:**

| | Baseline | Final | Δ |
|---|---|---|---|
| passed | 421 | **443** | **+22 ✓** |
| failed | 3 | **2** | -1 (only same pre-existing) |
| skipped | 53 | 39 | -14 (unskipped dead tests now run) |
| xfailed | 1 | 2 | +1 (new visible backend-bug signal) |
| runtime | 588s | **387s** | **-201s (34% faster)** |

**Zero tests that passed in baseline are now failing.** The 2 remaining
failures are the exact pre-existing ones
(`test_enrichment_table_join.py` backend panic + `test_workflow.py` SMTP
env-miss).

## What's in the diff

- **New `support/` framework** — `OpenObserveClient`, endpoint wrappers
(`alerts`, `dashboards`, `streams`, `search`, etc.), `wait_until()`,
payload factories, pytest fixtures, SSE parser. 14 framework selfcheck
tests.
- **16 of 16 OLD-tier test files rewritten** — using the new framework,
unique-suffix names, body validation, `wait_until` instead of
`time.sleep`, parametrize where appropriate.
- **29 files moved into 12 feature folders** mirroring the UI suite
layout
(`tests/{alerts,dashboards,ingest,orgs,pipelines,regression,rum,search,streams,users,workflow}/`).
- **−6,500 LOC net** (copy-paste + dead code removal; new framework adds
back ~1,500).
- **Ruff config** in pyproject.toml: T201 ban on `print()`, PT pytest
rules, B bugbear, UP pyupgrade.

## CI workflow changes

- New job `api_regression_tests`: `strategy.matrix` over the 4 env-flag
combinations (UTF8_VIEW × JOIN_MATCH_ONE) — now runs in parallel instead
of as 4 sequential server reboots in the main job.
- New job `api_fuzz_tests`: schemathesis OpenAPI-driven fuzz against
`/api-doc/openapi.json` (214 endpoints tested). Informational
(`continue-on-error: true`). Each run surfaces **7–10 distinct 5xx
panics** (e.g., empty `sql` body returning 500 instead of 400, traces
endpoints crashing on unescaped path params that get interpolated into
SQL). Filed to backend team for separate triage.
- Server `o2_*.log` files uploaded as artifacts on failure (was:
silently lost).
- `api_tests_summary` now requires BOTH integration + regression to
pass.

### CI infrastructure fixes

A short hardening pass landed after the initial CI run surfaced several
issues:

- **pytest-sugar count inflation** — dropped `--force-sugar` from both
pytest invocations. The flag double-registered sugar on top of the
auto-loaded entry point, inflating the CI test counter ~3x (display
showed 1364 when collection was 486). Counter is now honest.
- **schemathesis 4.x flag migration** — `--base-url` → `-u`,
`--hypothesis-max-examples` → `-n`, `--hypothesis-deadline` →
`--request-timeout`, `--data-generation-method` → `-m`, dropped
`--auth-type basic`. The fuzz job was failing immediately on flag-parse
before this.
- **Regression matrix binary path** — used `${{ github.workspace
}}/target/debug/openobserve` so the absolute path resolves correctly
under `working-directory: tests/api-testing/` (was: every matrix job
failed with "No such file or directory").
- **`permissions: contents: read`** added to all 4 workflow jobs —
closes CodeQL alert #369.
- **Removed redundant server boot** in `api_integration_tests` (leftover
from main's structure after the regression matrix split; was silently
failing to bind to :5080 and getting masked by the first server).

## Backend bugs surfaced (for backend team to track)

The rework uncovered and visibly flagged these as `xfail`/documented
test comments:

1. `DELETE /api/organizations/{id}` returns 404 unconditionally even for
just-created orgs — endpoint appears unimplemented.
2. `test_dashboard_missing_required_fields` triggers backend panic
(returns 500 instead of 400/422).
3. JS `getEnrichmentTableData()` restricted to `_meta` org AND not
exposed in the `/functions/test` endpoint runtime — `ReferenceError`
even with explicit `enrichment_tables: [...]`.
4. Bulk API silently sanitizes invalid `_index` values (`****` → `_`)
without flagging — user data lands in unexpected index.
5. `AVG` of a single value drifts by ~1e-14 (likely float reduction
order; documented tolerance in `test_advanced_sql.py`).
6. Org name validation rejects hyphens (only
`A-Z/a-z/0-9/spaces/underscores`) — not in spec.

Plus 7–10 additional 5xx panics surfaced per fuzz run (input validation
gaps — separate triage list in fuzz job logs).

## Test bugs uncovered + fixed

- `test_pipeline.py`: had two function definitions named
`test_pipeline_creation_and_action_with_schedule` — Python's last-wins
meant the first test's body never executed for years.
- `test_alertsV2.py`: `assert alert_disabled == "False"` was indented
inside an `else:` branch that never executed because the response is
always a dict; AND `enabled` is a bool, not the string `"False"`. Two
layers of broken.
- `test_bulk.py`: variable typo (`valid_bulk_payload` reused on the POST
call) made the invalid-index test silently duplicate the valid case.
- `test_organisations.py`: `test_create_organization` used pre-pytest-4
`yield`-style fixtures — silently ignored by pytest 8.
- `test_js_result_array.py`: 8 tests skipped with `"Temporarily disabled
- failing test"` — the actual cause was that JS functions are restricted
to `_meta` org. One-line fix unskipped all 8.
- `test_fuzzy.py`: 4 tests `@pytest.mark.skip`-ed because they used a
1-minute time window against older static test data → 0 hits → flake →
skip. Wider window unskips them.
- 547 LOC of zombie commented-out test blocks deleted (15 commented `#
def test_` definitions, including one orphan case where the `def` was
commented but the indented body wasn't).

## Folder layout

```
tests/api-testing/
├── support/                    # NEW framework
│   ├── client.py               # OpenObserveClient
│   ├── endpoints/              # 7 per-resource wrappers
│   ├── factories.py            # unique_name, time_window, *_payload
│   ├── wait.py                 # wait_until + WaitTimeout
│   ├── sse.py                  # read_sse_response
│   └── fixtures.py             # client, temp_user_email, temp_stream_name, ...
├── helpers/                    # Non-test shared code (was scattered in tests/)
│   ├── sourcemap_helpers.py
│   └── workflow/               # workflow chain + pages/ live here now
├── fixtures/
│   └── rum/                    # Standalone RUM ingest scripts (was in tests/)
└── tests/
    ├── alerts/                 # 3 files
    ├── dashboards/             # 4 files
    ├── ingest/                 # 4 files
    ├── orgs/                   # 2 files
    ├── pipelines/              # 10 files
    ├── regression/             # 2 files (env-flag matrix targets)
    ├── rum/                    # 3 files
    ├── search/                 # 8 files
    ├── streams/                # 1 file
    ├── users/                  # 1 file
    ├── workflow/               # 3 files
    ├── conftest.py
    └── test_framework_selfcheck.py
```

## Test plan

- [x] `rye run pytest --collect-only` — 486 tests discovered
- [x] Full default-set run (`--ignore=tests/regression`) — 443 pass / 2
fail / 39 skip / 2 xfail in 387s
- [x] `rye run pytest -m framework` — 14/14 selfcheck tests pass
- [x] `rye run ruff check support/ tests/test_framework_selfcheck.py` —
clean
- [x] CI run on this PR — `api_integration_tests` + all 4
`api_regression_tests` matrix jobs green
- [x] CI run — `api_fuzz_tests` runs cleanly (informational; surfaces
7–10 unique 5xx panics per run)

## Note on test count

The `test_streaming.py` rewrite folded 7 "tests" (`test_ingest_data`,
`test_ingest_join`, `test_disable_streaming`,
`test_update_max_query_range`, `test_enable_streaming`,
`test_delete_stream`, `test_delete_stream_join`) into pytest fixtures.
Each only checked `status_code == 200` of a setup/teardown operation —
they were imperative steps masquerading as tests. The fixtures still
perform the same operations and assert their success; they're just no
longer counted as discrete pytest items. **Functional coverage is
identical.**

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-06-01 07:19:48 +00:00

183 lines
6.4 KiB
Python

"""Log Ingestion API Tests.
Rewritten in Phase 4 of the api-tests revamp:
- Uses unique stream names per test via `temp_stream_name` fixture (no more
fixed `newpy_tests` that created hidden ordering dependencies).
- Replaces hardcoded Nov-2023 epoch timestamps in the VRL test with
current-time `time_window()` (the old timestamps had silently gone past
retention, returning 0 hits while still asserting status==200).
- Body validation: ingest response checks `status` field; stream list checks
for the stream's presence; schema response checks for known fields.
- Parametrize the two invalid-stream-name cases.
"""
from __future__ import annotations
import logging
from support.client import OpenObserveClient
from support.factories import time_window
logger = logging.getLogger(__name__)
ORG_ID = "default"
# Athletics records used as test payload — small, deterministic.
SAMPLE_LOG_RECORDS = [
{
"Athlete": "newtemp",
"City": "Athens",
"Country": "HUN",
"Discipline": "Swimming",
"Sport": "Aquatics",
"Year": 1896,
},
{
"Athlete": "HERSCHMANN",
"City": "Athens",
"Country": "CHN",
"Discipline": "Swimming",
"Sport": "Aquatics",
"Year": 1896,
},
]
# ----- ingest happy path -----
def test_ingest_logs_returns_200_and_records_count(
client: OpenObserveClient, temp_stream_name: str
):
"""POST /api/{org}/{stream}/_json returns 200 + a body listing what was ingested."""
resp = client.streams.ingest_json(temp_stream_name, SAMPLE_LOG_RECORDS)
assert resp.status_code == 200, resp.text
body = resp.json()
assert "status" in body, f"ingest response should have 'status' key: {body}"
# OO returns a per-record status array — verify count matches what we sent
statuses = body.get("status") or []
assert len(statuses) >= 1, f"expected at least 1 status entry, got {statuses}"
# ----- ingest error paths -----
def test_ingest_with_empty_stream_name_returns_400(
client: OpenObserveClient,
):
"""POST to /api/{org}//_json (empty stream segment) → 400.
Constructed manually because the client's urljoin would collapse the
double slash; we specifically want to test what OO does when the stream
name segment is present-but-empty.
"""
url = f"{client.base_url}api/{ORG_ID}//_json"
resp = client.session.post(url, json=SAMPLE_LOG_RECORDS)
assert resp.status_code == 400, \
f"empty stream name should be 400, got {resp.status_code}: {resp.text}"
def test_ingest_with_invalid_stream_name_returns_404(
client: OpenObserveClient,
):
"""POST with disallowed characters in stream name → 404."""
resp = client.post("newpy#$#$#$#$2@2/_json", json=SAMPLE_LOG_RECORDS)
assert resp.status_code == 404, \
f"invalid stream name should be 404, got {resp.status_code}: {resp.text}"
# ----- search/VRL -----
def test_vrl_query_against_ingested_stream(
client: OpenObserveClient, temp_stream_name: str
):
"""A VRL-augmented query against a freshly-ingested stream returns 200 + hits.
Replaces the legacy test that used hardcoded Nov-2023 epochs (which silently
returned 0 hits once past retention but still asserted status==200 — the
test would have masked complete breakage of VRL).
"""
# Ingest first so there's data to query
ing = client.streams.ingest_json(temp_stream_name, SAMPLE_LOG_RECORDS)
assert ing.status_code == 200, ing.text
# Use a real, current time window
start, end = time_window(minutes=30)
payload = {
"query": {
"sql": f'select * from "{temp_stream_name}"',
"start_time": start,
"end_time": end,
"from": 0,
"size": 150,
# base64 of `.a = 1\n .` — adds a constant field to each result
"query_fn": "LmEgPTEgCiAu",
}
}
resp = client.post("_search?type=logs", json=payload)
assert resp.status_code == 200, f"VRL query failed: {resp.status_code} {resp.text}"
body = resp.json()
assert "hits" in body, f"VRL response should have 'hits' key: {body}"
assert isinstance(body["hits"], list), "'hits' should be a list"
# Note: hits may be empty if ingest hasn't finished indexing — that's a
# separate concern. We're asserting the query CONTRACT here, not data
# latency (which is covered by the conftest ingest_data fixture for the
# session-wide test stream).
# ----- streams metadata -----
def test_list_streams_returns_list_with_known_baseline(
client: OpenObserveClient,
):
"""GET /api/{org}/streams returns a list including the session-wide stream_pytest_data."""
streams = client.streams.list()
assert isinstance(streams, list)
names = [s.get("name") for s in streams]
# stream_pytest_data is ingested by the autouse conftest fixture
assert "stream_pytest_data" in names, \
f"baseline stream missing from list: {names}"
def test_get_schema_after_ingest(
client: OpenObserveClient, temp_stream_name: str
):
"""After ingesting to a new stream, GET /streams/{name}/schema returns the field schema."""
client.streams.ingest_json(temp_stream_name, SAMPLE_LOG_RECORDS)
schema = client.streams.schema(temp_stream_name)
assert isinstance(schema, dict), f"schema should be a dict, got {type(schema).__name__}"
# OO schema responses include a 'schema' or 'fields' key
assert ("schema" in schema or "fields" in schema), \
f"schema response should have 'schema' or 'fields' key: {list(schema.keys())}"
# ----- delete -----
def test_delete_nonexistent_stream_returns_404(
client: OpenObserveClient,
):
"""DELETE /streams/{name} where name doesn't exist → 404."""
resp = client.streams.delete("definitely-does-not-exist-12345")
assert resp.status_code == 404, \
f"deleting nonexistent stream should be 404, got {resp.status_code}: {resp.text}"
# ----- settings error path -----
def test_put_stream_settings_without_body_returns_415(
client: OpenObserveClient, temp_stream_name: str
):
"""PUT /streams/{name}/settings without Content-Type body returns 415."""
# Ingest first to ensure the stream exists
client.streams.ingest_json(temp_stream_name, SAMPLE_LOG_RECORDS)
resp = client.put(f"streams/{temp_stream_name}/settings")
assert resp.status_code == 415, \
f"settings PUT without body should be 415, got {resp.status_code}: {resp.text}"