mirror of https://github.com/dapr/docs.git
				
				
				
			Added New Relic Logging section in operations/monitoring/logging
This commit is contained in:
		
							parent
							
								
									324e51fe03
								
							
						
					
					
						commit
						005590b32a
					
				|  | @ -86,7 +86,7 @@ spec: | |||
| 
 | ||||
| ## Log collectors | ||||
| 
 | ||||
| If you run Dapr in a Kubernetes cluster, [Fluentd](https://www.fluentd.org/) is a popular container log collector. You can use Fluentd with a [json parser plugin](https://docs.fluentd.org/parser/json) to parse Dapr JSON formatted logs. This [how-to]({{< ref fluentd.md >}}) shows how to configure the Fleuntd in your cluster. | ||||
| If you run Dapr in a Kubernetes cluster, [Fluentd](https://www.fluentd.org/) is a popular container log collector. You can use Fluentd with a [json parser plugin](https://docs.fluentd.org/parser/json) to parse Dapr JSON formatted logs. This [how-to]({{< ref fluentd.md >}}) shows how to configure the Fluentd in your cluster. | ||||
| 
 | ||||
| If you are using the Azure Kubernetes Service, you can use the default OMS Agent to collect logs with Azure Monitor without needing to install Fluentd. | ||||
| 
 | ||||
|  |  | |||
|  | @ -0,0 +1,78 @@ | |||
| --- | ||||
| type: docs | ||||
| title: "How-To: Set-up New Relic for Dapr logging" | ||||
| linkTitle: "New Relic" | ||||
| weight: 2000 | ||||
| description: "Set-up New Relic for Dapr logging" | ||||
| --- | ||||
| 
 | ||||
| ## Prerequisites | ||||
| 
 | ||||
| - Perpetually [free New Relic account](https://newrelic.com/signup), 100 GB/month of free data ingest, 1 free full access user, unlimited free basic users | ||||
| 
 | ||||
| ## Background | ||||
| 
 | ||||
| New Relic offers a [Fluent Bit](https://fluentbit.io/) output [plugin](https://github.com/newrelic/newrelic-fluent-bit-output) to easily forward your logs to [New Relic Logs](https://github.com/newrelic/newrelic-fluent-bit-output). This plugin is also provided in a standalone Docker image that can be installed in a Kubernetes cluster in the form of a DaemonSet, which we refer as the Kubernetes plugin. | ||||
| 
 | ||||
| This document explains how to install it in your cluster, either using a Helm chart (recommended), or manually by applying Kubernetes manifests. | ||||
| 
 | ||||
| ## Installation | ||||
| 
 | ||||
| ### Install using the Helm chart (recommended) | ||||
| 
 | ||||
| 1. Install Helm following the official instructions. | ||||
| 
 | ||||
| 2. Add the New Relic official Helm chart repository following these instructions | ||||
| 
 | ||||
| 3. Run the following command to install the New Relic Logging Kubernetes plugin via Helm, replacing the placeholder value YOUR_LICENSE_KEY with your [New Relic license key](https://docs.newrelic.com/docs/accounts/install-new-relic/account-setup/license-key): | ||||
| 
 | ||||
| - Helm 3 | ||||
| ``` | ||||
| helm install newrelic-logging newrelic/newrelic-logging --set licenseKey=YOUR_LICENSE_KEY | ||||
| ``` | ||||
| 
 | ||||
| - Helm 2 | ||||
| ``` | ||||
| helm install newrelic/newrelic-logging --name newrelic-logging --set licenseKey=YOUR_LICENSE_KEY | ||||
| ``` | ||||
| 
 | ||||
| For EU users, add `--set endpoint=https://log-api.eu.newrelic.com/log/v1 to any of the helm install commands above. | ||||
| 
 | ||||
| By default, tailing is set to /var/log/containers/*.log. To change this setting, provide your preferred path by adding --set fluentBit.path=DESIRED_PATH to any of the helm install commands above. | ||||
| 
 | ||||
| ### Install the Kubernetes manifes | ||||
| 
 | ||||
| 1. Download the following 3 manifest files into your current working directory: | ||||
| 
 | ||||
| ``` | ||||
| curl https://raw.githubusercontent.com/newrelic/helm-charts/master/charts/newrelic-logging/k8s/fluent-conf.yml > fluent-conf.yml | ||||
| curl https://raw.githubusercontent.com/newrelic/helm-charts/master/charts/newrelic-logging/k8s/new-relic-fluent-plugin.yml > new-relic-fluent-plugin.yml | ||||
| curl https://raw.githubusercontent.com/newrelic/helm-charts/master/charts/newrelic-logging/k8s/rbac.yml > rbac.yml | ||||
| ``` | ||||
| 
 | ||||
| 2. In the downloaded new-relic-fluent-plugin.yml file, replace the placeholder value LICENSE_KEY with your New Relic license key. | ||||
| 
 | ||||
| For EU users, replace the ENDPOINT environment variable to https://log-api.eu.newrelic.com/log/v1. | ||||
| 
 | ||||
| 3. Once the License key has been added, run the following command in your terminal or command-line interface: | ||||
| ``` | ||||
| kubectl apply -f . | ||||
| ``` | ||||
| 
 | ||||
| 4. [OPTIONAL] You can configure how the plugin parses the data by editing the parsers.conf section in the fluent-conf.yml file. For more information, see Fluent Bit's documentation on Parsers configuration. | ||||
| 
 | ||||
| By default, tailing is set to /var/log/containers/*.log. To change this setting, replace the default path with your preferred path in the new-relic-fluent-plugin.yml file. | ||||
| 
 | ||||
| 5. View Logs | ||||
| 
 | ||||
|  | ||||
| 
 | ||||
|  | ||||
| 
 | ||||
| ## Related Links/References | ||||
| 
 | ||||
| * [New Relic Account Signup](https://newrelic.com/signup) | ||||
| * [Telemetry Data Platform](https://newrelic.com/platform/telemetry-data-platform) | ||||
| * [New Relic Logging](https://github.com/newrelic/helm-charts/tree/master/charts/newrelic-logging) | ||||
| * [Types of New Relic API keys](https://docs.newrelic.com/docs/apis/get-started/intro-apis/types-new-relic-api-keys) | ||||
| * [Alerts and Applied Intelligence](https://docs.newrelic.com/docs/alerts-applied-intelligence) | ||||
|  | @ -1,9 +1,9 @@ | |||
| --- | ||||
| type: docs | ||||
| title: "How-To: Set-up New Relic for Dapr observability" | ||||
| title: "How-To: Set-up New Relic for distributed tracing" | ||||
| linkTitle: "New Relic" | ||||
| weight: 2000 | ||||
| description: "Set-up New Relic for Dapr observability" | ||||
| description: "Set-up New Relic for distributed tracing" | ||||
| --- | ||||
| 
 | ||||
| ## Prerequisites | ||||
|  |  | |||
										
											Binary file not shown.
										
									
								
							| After Width: | Height: | Size: 323 KiB | 
										
											Binary file not shown.
										
									
								
							| After Width: | Height: | Size: 331 KiB | 
		Loading…
	
		Reference in New Issue