To troubleshoot MART issues in Apigee hybrid, look at the log files. MART logs are
written to stdout/stderr and can be viewed using thekubectllogscommand.
On the Kubernetes administration machine, execute the following command:
The following error codes can occur in the MART logs:
Error
Description
ROUTING_SERVICE_NOT_ENABLED
routing.RoutingServiceNotEnabled
Occurs whenrouting.service.enableis set to false
in this file in the MART pod:/opt/apigee/edge-hybrid-mart-server/conf/routing-service.properties
HYBRID_MART_SERVER_ENDPOINT_NOT_FOUND
routing.HybridMARTServerEndpointNotFound
Occurs when the org does not have a value for the org property:features.mart.server.endpoint
HYBRID_AUTHN_AUTHZ_TOKEN_ERROR
routing.HybridAuthNAuthZTokenError
Occurs when the AuthN-AuthZ service returns a non-200 response
code or an invalid token
MART_ENDPOINT_REQUIRED
organizations.MartEndpointRequired
Occurs when the org propertyfeatures.mart.server.endpointhas
a null or empty value.
HTTPS_MART_ENDPOINT_REQUIRED
organizations.HttpsMartEndpointRequired
Occurs when the org propertyfeatures.mart.server.endpointhas a value starting with
"http://" whenmart.routing.https.validation.enableis
set to true in this file in the MART pod:/opt/apigee/edge-hybrid-mart-server/conf/routing-service.properties
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-29 UTC."],[[["\u003cp\u003eThis documentation version (1.7) for Apigee hybrid is end-of-life and an upgrade to a newer version is required.\u003c/p\u003e\n"],["\u003cp\u003eMART logs in Apigee hybrid can be viewed using the \u003ccode\u003ekubectl logs\u003c/code\u003e command on the Kubernetes administration machine.\u003c/p\u003e\n"],["\u003cp\u003eErrors like \u003ccode\u003eROUTING_SERVICE_NOT_ENABLED\u003c/code\u003e or \u003ccode\u003eHYBRID_MART_SERVER_ENDPOINT_NOT_FOUND\u003c/code\u003e may occur in MART logs, related to service settings and organization properties.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eHYBRID_AUTHN_AUTHZ_TOKEN_ERROR\u003c/code\u003e indicates an issue with the AuthN-AuthZ service's response or token, while \u003ccode\u003eMART_ENDPOINT_REQUIRED\u003c/code\u003e or \u003ccode\u003eHTTPS_MART_ENDPOINT_REQUIRED\u003c/code\u003e signals problems with the \u003ccode\u003efeatures.mart.server.endpoint\u003c/code\u003e property in the organization.\u003c/p\u003e\n"]]],[],null,["# MART logs\n\n| You are currently viewing version 1.7 of the Apigee hybrid documentation. **This version is end of life.** You should upgrade to a newer version. For more information, see [Supported versions](/apigee/docs/hybrid/supported-platforms#supported-versions).\n\nTo troubleshoot MART issues in Apigee hybrid, look at the log files. MART logs are\nwritten to stdout/stderr and can be viewed using the [`kubectl`](https://kubernetes.io/docs/reference/kubectl/overview/) `logs` command.\n\nOn the Kubernetes administration machine, execute the following command: \n\n```scdoc\nkubectl logs pod_name -n namespace\n```\n\nSee also [Logging](/apigee/docs/hybrid/v1.7/logging) for details.\n\n### MART error codes\n\nThe following error codes can occur in the MART logs:"]]
