{"record":{"id":"ac598a45047aa82a","repo":"BerriAI/litellm","slug":"unknown-mapper-name-name-r-known-known","errorCode":null,"errorMessage":"unknown mapper name {name!r}; known: {known}","messagePattern":"unknown mapper name (.+?); known: (.+?)","errorType":"validation","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"litellm/integrations/otel/mappers/__init__.py","lineNumber":47,"sourceCode":"_TOOL_DEFINITION_MAPPERS: Final[dict[str, Callable[[int], AttributeMapper]]] = {\n    \"genai\": GenAIMapper,\n    \"legacy\": LegacyMapper,\n    \"openinference\": OpenInferenceMapper,\n}\n_PLAIN_MAPPERS: Final[dict[str, Callable[[], AttributeMapper]]] = {\n    \"langfuse\": LangfuseMapper,\n    \"weave\": WeaveMapper,\n    \"langtrace\": LangtraceMapper,\n}\n\n\ndef resolve_mappers(names: Iterable[str]) -> list[AttributeMapper]:\n    \"\"\"Resolve mapper names to instances. Unknown names raise ``ValueError``.\"\"\"\n    ordered: Final = tuple(names)\n    for name in ordered:\n        if name not in _TOOL_DEFINITION_MAPPERS and name not in _PLAIN_MAPPERS:\n            known = sorted((*_TOOL_DEFINITION_MAPPERS, *_PLAIN_MAPPERS))\n            raise ValueError(f\"unknown mapper name {name!r}; known: {known}\")\n    # Distinct vocabularies each write the tool family under their own keys, so\n    # the ceiling is split by how many of them are configured. Repeating a name\n    # rewrites the same keys, so only distinct ones count.\n    budget: Final = tool_attr_budget(len({*ordered} & _TOOL_DEFINITION_MAPPERS.keys()))\n    return [\n        _TOOL_DEFINITION_MAPPERS[name](budget) if name in _TOOL_DEFINITION_MAPPERS else _PLAIN_MAPPERS[name]()\n        for name in ordered\n    ]\n\n\n__all__ = [\n    \"AttrValue\",\n    \"AttributeMap\",\n    \"AttributeMapper\",\n    \"GenAIMapper\",\n    \"LangfuseMapper\",\n    \"LangtraceMapper\",\n    \"LegacyMapper\",","sourceCodeStart":29,"sourceCodeEnd":65,"githubUrl":"https://github.com/BerriAI/litellm/blob/6c2dcb801bf2b75c18f1bb24140e7cf57465cc4d/litellm/integrations/otel/mappers/__init__.py#L29-L65","documentation":"Error \"unknown mapper name {name!r}; known: {known}\" thrown in BerriAI/litellm.","triggerScenarios":"Thrown at litellm/integrations/otel/mappers/__init__.py:47 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Use one of the known mapper names listed in the error."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"6c2dcb801bf2b75c18f1bb24140e7cf57465cc4d","analyzedAt":"2026-08-15T07:12:03.035Z","schemaVersion":2},"datasetVersion":"2026-08-15T17:31:12.345Z"}