Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat(whats-new): New Kong Gateway Logs Integration #19058

Merged
merged 5 commits into from
Oct 24, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
---
title: 'Forward logs from Kong Gateway to New Relic'
summary: 'Gain valuable insights into API gateway performance, health, security, and usage'
releaseDate: '2024-10-26'
learnMoreLink: 'https://docs.newrelic.com/docs/logs/forward-logs/kong-gateway/'
getStartedLink: 'https://docs.newrelic.com/docs/logs/ui-data/use-logs-ui/'
---

Today’s IT organizations using Kong Gateway often struggle to gain comprehensive visibility into their API performance, health, and security which can lead to unexpected issues, downtime, and security vulnerabilities.

New Relic's integration with Kong Gateway, using the File Log plugin, provides a robust solution for:

- **Centralized logging**: Kong Gateway logs are instantly contextualized with other application and telemetry data for a unified view.
- **Enhanced visibility**: Gain deeper insights into API gateway performance, health, and security.
- **Proactive issue detection**: Identify and address potential problems before they impact users.
- **Improved security**: Monitor for security threats and anomalies.

Check warning on line 16 in src/content/whats-new/2024/10/whats-new-10-23-kogs-gateway-logs-integration.md

View workflow job for this annotation

GitHub Actions / vale-linter

[vale] reported by reviewdog 🐶 [new-relic.ComplexWords] Consider using 'check' or 'watch' instead of 'Monitor'. Raw Output: {"message": "[new-relic.ComplexWords] Consider using 'check' or 'watch' instead of 'Monitor'.", "location": {"path": "src/content/whats-new/2024/10/whats-new-10-23-kogs-gateway-logs-integration.md", "range": {"start": {"line": 16, "column": 26}}}, "severity": "INFO"}
- **Optimized performance**: Identify and resolve performance bottlenecks before they impact uyser experience.

## Forward Kong Gateway logs

The File Log plugin for Kong Gateway enables the forwarding of logs to New Relic by directing them to standard output (`/dev/stdout`). This setup allows New Relic’s Kubernetes logging plugin integration to collect and forward the logs.

## Configuration setup

Follow these steps:

**Step 1: Install the New Relic Kubernetes logging integration**

Before configuring the File Log plugin, ensure you have the New Relic Kubernetes logging integration installed. Follow the [instructions](https:/docs.newrelic.com/docs/logs/forward-logs/kubernetes-plugin-log-forwarding/) to set this up.

**Step 2: Install and configure Kong File Log plugin**

Once the New Relic Logging Integration is installed, configure the File Log to output logs to `/dev/stdout` . See an example of the manifest configuration file in the [Configure the File Log plugin](https://docs.newrelic.com/docs/logs/forward-logs/kong-gateway/#install-config-filelog) section.

Check warning on line 33 in src/content/whats-new/2024/10/whats-new-10-23-kogs-gateway-logs-integration.md

View workflow job for this annotation

GitHub Actions / vale-linter

[vale] reported by reviewdog 🐶 [Microsoft.Passive] 'is installed' looks like passive voice. Raw Output: {"message": "[Microsoft.Passive] 'is installed' looks like passive voice.", "location": {"path": "src/content/whats-new/2024/10/whats-new-10-23-kogs-gateway-logs-integration.md", "range": {"start": {"line": 33, "column": 40}}}, "severity": "INFO"}

**Step 3: Apply the Log File Log plugin configuration**

* Deploy the File Log plugin configuration to your Kubernetes cluster using the following command:

```bash
kubectl apply -f file-log-plugin.yaml -n kong
```

* Replace `file-log-plugin.yaml` with the actual filename of your manifest.

**Step 4: Verify the configuration**

After applying the configuration, verify that logs are being forwarded to New Relic by checking the [New Relic Logs UI](https://one.newrelic.com/launcher/logger.log-launcher) for entries from Kong Gateway.

Check warning on line 47 in src/content/whats-new/2024/10/whats-new-10-23-kogs-gateway-logs-integration.md

View workflow job for this annotation

GitHub Actions / vale-linter

[vale] reported by reviewdog 🐶 [Microsoft.Passive] 'being forwarded' looks like passive voice. Raw Output: {"message": "[Microsoft.Passive] 'being forwarded' looks like passive voice.", "location": {"path": "src/content/whats-new/2024/10/whats-new-10-23-kogs-gateway-logs-integration.md", "range": {"start": {"line": 47, "column": 58}}}, "severity": "INFO"}

By forwarding Kong Gateway logs to New Relic, organizations can effectively monitor and manage their API gateways, ensuring optimal performance and security.

Check warning on line 49 in src/content/whats-new/2024/10/whats-new-10-23-kogs-gateway-logs-integration.md

View workflow job for this annotation

GitHub Actions / vale-linter

[vale] reported by reviewdog 🐶 [new-relic.ComplexWords] Consider using 'check' or 'watch' instead of 'monitor'. Raw Output: {"message": "[new-relic.ComplexWords] Consider using 'check' or 'watch' instead of 'monitor'.", "location": {"path": "src/content/whats-new/2024/10/whats-new-10-23-kogs-gateway-logs-integration.md", "range": {"start": {"line": 49, "column": 79}}}, "severity": "INFO"}

## To get started

1. [Read our tutorial](https://docs.newrelic.com/docs/tutorial-manage-large-log-volume/get-started-managing-large-logs/)
2. [Review our docs page](https://docs.newrelic.com/docs/logs/forward-logs/kong-gateway/)
3. [Explore our Logs UI overview](https://docs.newrelic.com/docs/logs/ui-data/use-logs-ui/)

Loading