API Gateway 11.1 | Administering API Gateway | Deployment | Deployment Configurations | Connecting to an External Kibana
 
Connecting to an External Kibana
Considerations when you configure an external Kibana:
*Ensure the external Kibana version is compatible with the external Elasticsearch version as external Kibana and external Elasticsearch have a one-to-one mapping. For details on version compatibility, see Support Matrix.
*Turn off external Kibana auto start in one of the following ways:
*By using externalized configuration files. For details, see Using the Externalized Configuration Files. It is recommended to use this configuration.
*By setting the property apigw.kibana.autostart to false located in C:/Install_Dir/msr/apigatewayui/webapps/apigatewayui/WEB-INF/classes/com/uiconfiguration.properties.
You can have one of the following external Kibana configurations:
*External Kibana connected to external Elasticsearch.
You can configure this setup as follows:
For an external Kibana to connect to external Elasticsearch you have to configure the following properties in the kibana.yml file where you have installed the external Kibana.
Note:
The default index is .kibana and it is not configured by users.
Property
Description
server.port: port number
Specifies which server port to use.
Example: 9405
server.host: server host IP address or host name
Specifies the host to bind the server to.
The default value is localhost, which means the remote machines will not be able to connect. To allow connections for remote users you must set this parameter to a non-loopback address.
Example: "0.0.0.0"
server.basePath: server path of the proxy
Specifies the proxy setting to render the charts from the external Kibana in API Gateway UI.
The server path you specify must not end with a /.
Value: "/apigatewayui/dashboardproxy"
elasticsearch.hosts: http://hostname:port
Specifies the URLs of the external Elasticsearch instance to use for all your queries.
Example: ["http://localhost:9240"]
You can copy these values in the kibana.yml file of the external Kibana in Install_Dir\\profiles\IS_default\apigateway\dashboard\config
If you are using an external Kibana version different than the one shipped with API Gateway that is compatible with the external Elasticsearch version, you have to specify the external Kibana version in the config.json file located at Install_Dir\msr\IntegrationServer\packages\WmAPIGateway\config\resources\kibana\config\7\. For details on version compatibility, see Support Matrix.
*External Kibana connected to external Elasticsearch to store all API Gateway assets then configure the following:
Open the kibana.yml file located at C:\Install_Dir\\profiles\IS_default\apigateway\dashboard\config and specify the external Elasticsearch host and port details, which the external Kibana has to connect to, as follows:
# The Elasticsearch instance to use for all your queries.
elasticsearch.hosts: ["http://host_name:port"]
*External Kibana connected to an external Elasticsearch.
You can configure this setup by using externalized configuration files. For details, see Using the Externalized Configuration Files.
Note:
When using external Elasticsearch and external Kibana the startup of the components must follow the following order:
1. Start external Elasticsearch and verify the cluster health.
2. Start the API Gateway service.
3. After API Gateway is started and available, start external Kibana.