:_mod-docs-content-type: ASSEMBLY
[id="threescale-adapter"]
= Using the 3scale Istio adapter
include::_attributes/common-attributes.adoc[]
:context: threescale-adapter

toc::[]

The 3scale Istio Adapter is an optional adapter that allows you to label a service running within the {SMProductName} and integrate that service with the 3scale API Management solution.
It is not required for {SMProductName}.

[IMPORTANT]
====
You can only use the 3scale Istio adapter with {SMProductName} versions 2.0 and below. The Mixer component was deprecated in release 2.0 and removed in release 2.1. For {SMProductName} versions 2.1.0 and later you should use the xref:../../service_mesh/v2x/ossm-threescale-webassembly-module.adoc#ossm-threescale-webassembly-module[3scale WebAssembly module].

If you want to enable 3scale backend cache with the 3scale Istio adapter, you must also enable Mixer policy and Mixer telemetry. See xref:../../service_mesh/v2x/ossm-create-smcp.adoc#ossm-create-smcp[Deploying the Red Hat OpenShift Service Mesh control plane].
====

include::modules/ossm-threescale-integrate.adoc[leveloffset=+1]

include::modules/ossm-threescale-cr.adoc[leveloffset=+2]

include::modules/ossm-threescale-templates.adoc[leveloffset=+3]

include::modules/ossm-threescale-manifests.adoc[leveloffset=+2]

include::modules/ossm-threescale-routing.adoc[leveloffset=+2]

include::modules/ossm-threescale-integration-settings.adoc[leveloffset=+1]

include::modules/ossm-threescale-caching.adoc[leveloffset=+1]

include::modules/ossm-threescale-authentication.adoc[leveloffset=+1]

include::modules/ossm-threescale-metrics.adoc[leveloffset=+1]

include::modules/threescale-backend-cache.adoc[leveloffset=+1]

include::modules/threescale-istio-adapter-apicast.adoc[leveloffset=+1]

include::modules/ossm-threescale-istio-adapter-verification.adoc[leveloffset=+1]

[role="_additional-resources"]
.Additional resources
* link:https://docs.openshift.com/container-platform/4.7/support/troubleshooting/investigating-pod-issues.html#inspecting-pod-and-container-logs_investigating-pod-issues[Inspecting pod and container logs].

include::modules/ossm-threescale-istio-adapter-troubleshooting-checklist.adoc[leveloffset=+1]
