Skip to content
Notifications
Clear all

Am I the only one who thinks the docs assume too much prior knowledge?

2 Posts
2 Users
0 Reactions
1 Views
(@data_analytics_rover)
Reputable Member
Joined: 4 months ago
Posts: 150
Topic starter   [#16760]

I've been evaluating Arize AI for model performance monitoring over the last two weeks, and I keep hitting the same friction point: the documentation seems to be written for someone who already has a fully-instrumented MLOps pipeline. As an analytics engineer coming from the BI/dimensional modeling world, the conceptual leap is significant.

For instance, the quickstart guide for integrating model predictions assumes you're already logging with `phoenix` or have a specific serving layer. When I attempted to send a batch of historical inferences from our Snowflake model output table, the required data shape wasn't immediately clear. The docs show:

```python
from arize.pandas.logger import Client

response = client.log(
dataframe=df,
model_id='model_name',
model_version='1.0',
...
)
```

But the critical piece—the exact schema of `df`—requires digging through three separate pages to reconcile. The `prediction_label`, `prediction_score`, `actual_label`, and `actual_score` columns are explained, but the handling of timestamps for joins and the structure for embedding vectors felt like assumed knowledge.

* Is the expectation that you've used a tool like Whylabs or Evidently before?
* The gap between "log a simple example" and "configure for a real, batch-based production model" seems large.
* I couldn't find a reference implementation for a common stack like: dbt models -> feature store -> batch predictions in Snowflake -> Arize.

This isn't a critique of the tool's capability, which seems robust. It's about the onboarding experience. For teams without dedicated ML platform engineers, the learning curve is steep. I'm interested to hear if others in the community had a similar experience, and how you bridged the knowledge gap. Did you rely more on support, or piece it together from community examples?



   
Quote
(@amandaj)
Reputable Member
Joined: 1 week ago
Posts: 148
 

You're right about the df schema being scattered. I ran into the same thing last month when trying to log batch predictions from a Postgres table. The timestamp join logic was particularly unclear - the docs mention `prediction_timestamp` and `actual_timestamp` separately, but don't explicitly state that leaving `actual_timestamp` null will default to using the prediction timestamp for joins in the UI. I ended up having to infer this from a GitHub issue comment.

For embeddings, I found the expectation is that you already know the column should be a list of floats. They don't give a clear example for a dataframe with, say, a `text_embedding` column that needs conversion from a string representation. It forces you to map MLOps concepts directly to pandas operations without a bridge for analysts.


Data > opinions


   
ReplyQuote