litellm/tests/pass_through_tests/test_vertex_ai.py
Mateo Wang a7d8c6f467
test(pass-through): de-flake vertex spend-log test by routing through the proxy (#31689)
* test(pass-through): de-flake vertex spend-log assertion by re-billing

The vertex pass-through spend-log test asserted that a single billed
generateContent call moved the global spend aggregate within a fixed
wait. CI failures show the call returning a valid response with real
usage, yet spend never increasing over a 240s poll.

Pass-through spend logging is best-effort: the success handler is
enqueued on a background worker that can drop or time out an individual
event under load and never retries it, so one billed call occasionally
never reaches LiteLLM_SpendLogs. Waiting longer cannot recover a dropped
event; only re-issuing the call can.

Re-bill the call up to a few times and require at least one to be
tracked, mirroring the sibling jest test that already retries. The test
still fails hard if cost tracking is actually broken, since then every
call records nothing. Also sum spend across all returned days instead of
matching the runner's local 'today', removing a separate UTC-rollover
flake.

* test(pass-through): route vertex spend-log test through proxy via direct HTTP

The vertexai SDK, configured with location="global" and an http api_endpoint
override, intermittently sends generateContent to the public Vertex endpoint
instead of the proxy. Proxy logs from a failing run show all 46 of the test's
own spend-log polls reaching the proxy while zero generateContent calls did, so
LiteLLM never saw the billed call and no spend was ever recorded; re-billing
through the SDK could not help because every retry bypassed the proxy too.

Issue the pass-through request directly over HTTP so it always hits the proxy,
minting a Google token from the same service-account credentials, then assert
that the specific call's own spend log lands with spend > 0, a gemini model, and
custom_llm_provider vertex_ai. A small best-effort retry covers the rare case
where the background logging worker drops a single event; failing every attempt
still fails hard so the test keeps its teeth if cost tracking breaks.

* test(pass-through): reuse LITE_LLM_ENDPOINT and drop needless async in get_tracked_spend
2026-06-30 15:27:48 -07:00

250 lines
8.5 KiB
Python

"""
Test Vertex AI Pass Through
1. use Credentials client side, Assert SpendLog was created
"""
import vertexai
from vertexai.preview.generative_models import GenerativeModel
import tempfile
import json
import os
import pytest
import asyncio
import requests
# Path to your service account JSON file
SERVICE_ACCOUNT_FILE = "path/to/your/service-account.json"
def load_vertex_ai_credentials():
# Define the path to the vertex_key.json file
print("loading vertex ai credentials")
filepath = os.path.dirname(os.path.abspath(__file__))
vertex_key_path = filepath + "/vertex_key.json"
# Read the existing content of the file or create an empty dictionary
try:
with open(vertex_key_path, "r") as file:
# Read the file content
print("Read vertexai file path")
content = file.read()
# If the file is empty or not valid JSON, create an empty dictionary
if not content or not content.strip():
service_account_key_data = {}
else:
# Attempt to load the existing JSON content
file.seek(0)
service_account_key_data = json.load(file)
except FileNotFoundError:
# If the file doesn't exist, create an empty dictionary
service_account_key_data = {}
# Update the service_account_key_data with environment variables
private_key_id = os.environ.get("VERTEX_AI_PRIVATE_KEY_ID", "")
private_key = os.environ.get("VERTEX_AI_PRIVATE_KEY", "")
private_key = private_key.replace("\\n", "\n")
service_account_key_data["private_key_id"] = private_key_id
service_account_key_data["private_key"] = private_key
# print(f"service_account_key_data: {service_account_key_data}")
# Create a temporary file
with tempfile.NamedTemporaryFile(mode="w+", delete=False) as temp_file:
# Write the updated content to the temporary files
json.dump(service_account_key_data, temp_file, indent=2)
# Export the temporary file as GOOGLE_APPLICATION_CREDENTIALS
os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = os.path.abspath(temp_file.name)
LITE_LLM_ENDPOINT = "http://localhost:4000"
SPEND_LOG_API_KEY = "best-api-key-ever"
def get_tracked_spend() -> float:
"""
Total spend recorded under the pass-through key in the global spend view.
Sums every day the endpoint returns instead of matching the runner's local
"today" so a UTC date rollover mid-test can't hide a freshly billed call, and
treats an unreachable endpoint as "nothing recorded yet" (0.0).
"""
url = f"{LITE_LLM_ENDPOINT}/global/spend/logs?api_key={SPEND_LOG_API_KEY}"
response = requests.get(url, headers={"Authorization": "Bearer sk-1234"})
if response.status_code != 200:
print(f"global spend logs endpoint returned {response.status_code}: {response.text}")
return 0.0
rows = response.json()
print("global spend logs rows", rows)
return sum(float(row.get("spend") or 0.0) for row in rows)
VERTEX_PROJECT = "litellm-ci-cd"
VERTEX_MODEL = "gemini-3.1-flash-lite"
VERTEX_GENERATE_CONTENT_URL = (
f"{LITE_LLM_ENDPOINT}/vertex_ai/v1/projects/{VERTEX_PROJECT}"
f"/locations/global/publishers/google/models/{VERTEX_MODEL}:generateContent"
)
def _vertex_access_token() -> str:
import google.auth
import google.auth.transport.requests
credentials, _ = google.auth.default(
scopes=["https://www.googleapis.com/auth/cloud-platform"]
)
credentials.refresh(google.auth.transport.requests.Request())
return credentials.token
def _spend_log_for_request(call_id: str) -> dict | None:
response = requests.get(
f"{LITE_LLM_ENDPOINT}/spend/logs?request_id={call_id}",
headers={"Authorization": "Bearer sk-1234"},
timeout=30,
)
if response.status_code != 200:
return None
rows = response.json()
return rows[0] if rows else None
def _is_vertex_quota_error(response: requests.Response) -> bool:
return response.status_code == 429 or "RESOURCE_EXHAUSTED" in response.text
@pytest.mark.asyncio()
async def test_basic_vertex_ai_pass_through_with_spendlog():
load_vertex_ai_credentials()
access_token = _vertex_access_token()
# Drive the pass-through over HTTP instead of the vertexai SDK: the SDK intermittently
# routes generateContent to the public Vertex endpoint rather than the proxy override,
# so the call never reaches LiteLLM and no spend is logged. A direct request always
# hits the proxy. Spend logging then runs on a best-effort background worker that can
# drop a single event, so retry a few billed calls and assert that one specific call's
# spend log lands. Failing every attempt still fails hard, which is the signal we want
# if cost tracking is broken.
max_attempts = 3
poll_seconds = 60
poll_interval = 5
for attempt in range(1, max_attempts + 1):
response = requests.post(
VERTEX_GENERATE_CONTENT_URL,
headers={
"Authorization": f"Bearer {access_token}",
"Content-Type": "application/json",
},
json={"contents": [{"role": "user", "parts": [{"text": "hi"}]}]},
timeout=60,
)
if _is_vertex_quota_error(response):
pytest.skip("Vertex AI quota exhausted")
assert (
response.status_code == 200
), f"vertex pass-through call failed: {response.status_code} {response.text}"
call_id = response.headers.get("x-litellm-call-id")
assert call_id, "proxy response missing x-litellm-call-id header"
for _ in range(poll_seconds // poll_interval):
await asyncio.sleep(poll_interval)
row = _spend_log_for_request(call_id)
if row is not None and float(row.get("spend") or 0) > 0:
assert "gemini" in row["model"], f"unexpected model in spend log: {row}"
assert (
row["custom_llm_provider"] == "vertex_ai"
), f"unexpected provider in spend log: {row}"
return
print(f"attempt {attempt}: spend log for call {call_id} not found yet, re-billing")
pytest.fail(
f"Vertex pass-through spend never recorded after {max_attempts} billed calls"
)
@pytest.mark.asyncio()
@pytest.mark.skip(reason="skip flaky test - vertex pass through streaming is flaky")
async def test_basic_vertex_ai_pass_through_streaming_with_spendlog():
spend_before = get_tracked_spend()
print("spend_before", spend_before)
load_vertex_ai_credentials()
vertexai.init(
project="litellm-ci-cd",
location="global",
api_endpoint=f"{LITE_LLM_ENDPOINT}/vertex_ai",
api_transport="rest",
)
model = GenerativeModel(model_name="gemini-3.1-flash-lite")
response = model.generate_content("hi", stream=True)
for chunk in response:
print("chunk", chunk)
print("response", response)
await asyncio.sleep(20)
spend_after = get_tracked_spend()
print("spend_after", spend_after)
assert (
spend_after > spend_before
), "Spend should be greater than before. spend_before: {}, spend_after: {}".format(
spend_before, spend_after
)
pass
@pytest.mark.skip(
reason="skip flaky test - google context caching is flaky and not reliable."
)
@pytest.mark.asyncio
async def test_vertex_ai_pass_through_endpoint_context_caching():
import vertexai
from vertexai.generative_models import Part
from vertexai.preview import caching
import datetime
# load_vertex_ai_credentials()
vertexai.init(
project="litellm-ci-cd",
location="global",
api_endpoint=f"{LITE_LLM_ENDPOINT}/vertex_ai",
api_transport="rest",
)
system_instruction = """
You are an expert researcher. You always stick to the facts in the sources provided, and never make up new facts.
Now look at these research papers, and answer the following questions.
"""
contents = [
Part.from_uri(
"gs://cloud-samples-data/generative-ai/pdf/2312.11805v3.pdf",
mime_type="application/pdf",
),
Part.from_uri(
"gs://cloud-samples-data/generative-ai/pdf/2403.05530.pdf",
mime_type="application/pdf",
),
]
cached_content = caching.CachedContent.create(
model_name="gemini-3.1-flash-lite",
system_instruction=system_instruction,
contents=contents,
ttl=datetime.timedelta(minutes=60),
# display_name="example-cache",
)
print(cached_content.name)