mirror of
https://github.com/hasura/graphql-engine.git
synced 2024-12-17 12:31:52 +03:00
99cb846911
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: Rikin Kachhia <54616969+rikinsk@users.noreply.github.com> GitOrigin-RevId: 00fbbfdc5b9688459fbfbb54824708292859ffa5
142 lines
5.0 KiB
ReStructuredText
142 lines
5.0 KiB
ReStructuredText
.. meta::
|
|
:description: Datadog Integration on Hasura Cloud
|
|
:keywords: hasura, docs, metrics, integration, export logs, datadog
|
|
|
|
.. _ss_datadog_integration:
|
|
|
|
Datadog Integration
|
|
===================
|
|
|
|
.. contents:: Table of contents
|
|
:backlinks: none
|
|
:depth: 2
|
|
:local:
|
|
|
|
Introduction
|
|
------------
|
|
|
|
You can export metrics and operation logs of your Hasura Cloud project to your organisation's Datadog dashboard. This can be configured
|
|
on the integrations tab on the project's setting page.
|
|
|
|
.. note::
|
|
|
|
Datadog Integration is only available for Hasura Cloud projects on the ``Standard`` (pay-as-you-go) tier and above.
|
|
|
|
Configure Datadog integration
|
|
-----------------------------
|
|
|
|
Navigate to the integrations tab on project settings page to find Datadog integration.
|
|
|
|
.. thumbnail:: /img/graphql/cloud/metrics/integrate-datadog.png
|
|
:alt: Configure Datadog Integration
|
|
:width: 1146px
|
|
|
|
Select the Datadog API region and enter the Datadog API key (can be retrieved by navigating to Datadog's settings page by clicking the ``Get API Key`` link), host, service name and tags to associate with exported logs and metrics.
|
|
|
|
.. list-table::
|
|
:header-rows: 1
|
|
:widths: 20 40
|
|
|
|
* - Field
|
|
- Description
|
|
|
|
* - Region
|
|
- If you are in the Datadog EU site (app.datadoghq.eu), the Region should be EU; otherwise, it should be US.
|
|
|
|
* - API Key
|
|
- API keys are unique to your organization. An API key is required by the Datadog Agent to submit metrics and events to Datadog. You can get the API key from `here <https://app.datadoghq.com/account/settings#api>`__ if you are in Datadog US region and `here <https://app.datadoghq.eu/account/settings#api>`__ if you're in Datadog EU region.
|
|
|
|
* - Host
|
|
- The name of the originating host of the log and metrics.
|
|
|
|
* - Tags
|
|
- Tags associated with your logs and metrics. Default tags ``project_id`` and ``project_name`` are exported with all logs and metrics. A source tag ``hasura-cloud-metrics`` is added to all exported logs.
|
|
|
|
* - Service Name
|
|
- The name of the application or service generating the log events.
|
|
|
|
.. thumbnail:: /img/graphql/cloud/metrics/configure-datadog.png
|
|
:alt: Configure Datadog Integration
|
|
:width: 437px
|
|
|
|
After adding appropriate values, click ``Save``.
|
|
|
|
Checking the status of the integration
|
|
--------------------------------------
|
|
|
|
The green/red dot signifies the status of the integration. Green signifies successful exporting of logs to datadog.
|
|
When logs are successfully exported, ``Last Exported`` is continuously updated, indicating the timestamp of the last log line successfully exported to your Datadog dashboard.
|
|
|
|
.. thumbnail:: /img/graphql/cloud/metrics/configure-datadog-done.png
|
|
:alt: Datadog Integration successfully configured
|
|
:width: 1146px
|
|
|
|
In case there is an error while exporting logs to datadog, the dot is red and the HTTP status code of the error is displayed right below it.
|
|
|
|
.. thumbnail:: /img/graphql/cloud/metrics/configure-datadog-fail.png
|
|
:alt: Datadog Integration successfully configured
|
|
:width: 1146px
|
|
|
|
View logs
|
|
---------
|
|
|
|
The logs can be viewed in your Datadog dashboard, under the ``Logs`` tab. To navigate to the same, click ``View Logs``.
|
|
|
|
.. thumbnail:: /img/graphql/cloud/metrics/datadog-view-logs.png
|
|
:alt: Datadog Integration successfully configured
|
|
:width: 1146px
|
|
|
|
.. thumbnail:: /img/graphql/cloud/metrics/datadog-logs.png
|
|
:alt: Logs successfully exported to Datadog
|
|
:width: 1146px
|
|
|
|
To view only logs exported by Hasura Cloud, filter your logs using ``host`` and/or ``tags`` you configured with this integration.
|
|
|
|
.. note::
|
|
|
|
Datadog allows ingestion of logs with maximum size 256kB for a single log. If a log exceeds this limit, Datadog
|
|
will truncate the log at 256kB.
|
|
|
|
View metrics
|
|
------------
|
|
|
|
The integration exports the following five metrics to your Datadog dashboard:
|
|
|
|
.. list-table::
|
|
:header-rows: 1
|
|
:widths: 30 30
|
|
|
|
* - Metric Exported
|
|
- Metric Name in Datadog
|
|
|
|
* - Average number of requests
|
|
- ``average_requests_per_minute``
|
|
|
|
* - Average request execution time
|
|
- ``average_execution_time``
|
|
|
|
* - Success rate of requests
|
|
- ``success_rate``
|
|
|
|
* - Active subscriptions
|
|
- ``active_subscriptions``
|
|
|
|
* - Number of websockets open
|
|
- ``websockets_open``
|
|
|
|
Non zero values of all the above metrics are exported over a one minute time interval. Each metric name
|
|
is prefixed with ``hasura_cloud``.
|
|
|
|
Graphs for all the above metrics can be viewed in your Datadog dashboard, under the ``Metrics`` tab. To navigate to the same, click ``View Metrics``.
|
|
|
|
.. thumbnail:: /img/graphql/cloud/metrics/datadog-view-metrics.png
|
|
:alt: Datadog Integration successfully configured
|
|
:width: 1146px
|
|
|
|
Select the graphs you want to view from the metrics explorer. Alternatively, select the ``host`` you configured with this integration to see all the
|
|
graphs corresponding to metrics exported by Hasura Cloud.
|
|
|
|
.. thumbnail:: /img/graphql/cloud/metrics/datadog-metrics.png
|
|
:alt: Metrics successfully exported to Datadog
|
|
:width: 1146px
|