Skip to content
This repository was archived by the owner on Nov 19, 2024. It is now read-only.

Commit b5119a8

Browse files
authored
Updates for New Relic Logs documentation (#7614)
* Updates for New Relic Logs documentation: - Revised introduction to View and manage logs topic - Updated the screen capture to access New Relic Logs from the APM application view to show callout for Logs selection - Miscellaneous edits * Editorial change
1 parent b1bc069 commit b5119a8

File tree

4 files changed

+18
-16
lines changed

4 files changed

+18
-16
lines changed

src/cloud/architecture/scaled-architecture.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -100,7 +100,7 @@ project-id@server-id:~$
100100

101101
The log locations vary slightly depending on the node. For example, a database log, such as the **MySQL error log**, is available on a core node (`/var/log/mysql/mysql-error.log`), but it is not available on a web node.
102102

103-
Each Pro plan account includes the [New Relic Logs service][nri], which automatically connects with log data from the application to provide dynamic log management. Aggregated log data from all nodes displays in the New Relic Logs UI so you can troubleshoot performance issues on specific nodes from a single dashboard.
103+
Each Pro plan account includes the [New Relic Logs service][nri], which automatically connects with log data from the application to provide dynamic log management. Aggregated log data from all nodes displays in the New Relic Logs application so that you can troubleshoot performance issues on specific nodes from a single dashboard.
104104

105105
<!-- Link definitions -->
106106
[Core tier scaling]: {{ site.baseurl }}/common/images/cloud/scaling-core.png

src/cloud/project/log-locations.md

Lines changed: 11 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,33 +1,28 @@
11
---
22
group: cloud-guide
3-
title: View logs
3+
title: View and manage logs
44
functional_areas:
55
- Cloud
66
- Configuration
77
redirect_from:
88
- /cloud/trouble/environments-logs.html
99
---
10-
Logs are useful for troubleshooting problems related to {{site.data.var.ece}} [build and deploy hooks][hook].
1110

12-
{:.bs-callout-info}
13-
Magento-specific logs are in the `<magento-root-dir>/var/` directory. See [Magento Logging][configlog] in the _Configuration guide_.
11+
Logs for {{site.data.var.ece}} projects are useful for troubleshooting problems related to {{site.data.var.ece}} [build and deploy hooks][hook], cloud services, and the Magento application.
1412

15-
{:.bs-callout-tip}
16-
When you configure your Cloud environment, you can [set up log-based Slack and email notifications][slacklog] for build and deploy actions.
17-
18-
## Viewing logs
19-
20-
There are three ways to view logs: file system, project web UI, `magento-cloud` CLI.
13+
You can view the logs from the file system, the project web UI, and the `magento-cloud` CLI.
2114

22-
- **Log directories**—The `/var/log` system directory contains logs for all environments. The `var/log/` Magento directory contains app-specific logs unique to a particular environment. You must use an SSH connection to access logs in a remote server environment. These directories are not shared between nodes in a cluster. In Pro Production and Staging environments, you must check the logs on each node.
15+
- **File system**—The `/var/log` system directory contains logs for all environments. The `var/log/` Magento directory contains app-specific logs unique to a particular environment. You must use an SSH connection to access logs in a remote server environment. These directories are not shared between nodes in a cluster. In Pro Production and Staging environments, you must check the logs on each node.
2316

2417
- **Project web UI**—You can see build and post-deploy log information in the environment _messages_ list.
2518

2619
- **Magento Cloud CLI**—You can view logs using the `magento-cloud log` command.
2720

28-
### Aggregated log data
21+
## Manage log data
2922

30-
On Pro Production and Staging environments, you can review and analyze aggregated data from all {{ site.data.var.ece }} logs using the New Relic Logs service. See [New Relic services][].
23+
On Pro Production and Staging environments, use the New Relic Logs application integrated with your project to manage aggregated log data from all logs associated with your {{ site.data.var.ece }} project.
24+
25+
The New Relic Logs application provides a centralized log management dashboard to troubleshoot and monitor {{site.data.var.ece}} Production and Staging environments. The dashboard also provides access to log data for Fastly CDN, Image Optimization, and Web application firewall (WAF) services. See [New Relic services][].
3126

3227
### Log command
3328

@@ -78,6 +73,9 @@ Re-deploying environment project-integration-ID
7873
[2019-01-03 19:44:32] NOTICE: Post-deploy is complete.
7974
```
8075

76+
{:.bs-callout-tip}
77+
When you configure your Cloud environment, you can set up [log-based Slack and email notifications][slacklog] for build and deploy actions.
78+
8179
### Error logs
8280

8381
Error and warning messages generated during the deployment process are written to both the `var/log/cloud.log` and the `var/log/cloud.error.log` files. The Cloud error log file contains only errors and warnings from the latest deployment. An empty file indicates a successful deployment with no errors.

src/cloud/project/new-relic.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,7 @@ The aggregated data includes information from the following logs:
4646
As soon as your project is connected to New Relic, you can use the New Relic Logs service to complete tasks like the following:
4747

4848
- Use [New Relic queries][New Relic query syntax for logs] to search aggregated log data
49-
- Visualize log data through the New Relic UI
49+
- Visualize log data through the New Relic Logs application
5050
- Create custom charts, dashboards, and alerts
5151
- Troubleshoot performance issues from a single dashboard
5252

@@ -221,7 +221,10 @@ To use the New Relic Logs application:
221221

222222
1. On the _APM applications page_, select **Logs** from the navigation menu.
223223

224-
![Cloud project APM menu select Logs page]({{ site.baseurl }}/common/images/cloud/cloud-newrelic-dashboard-basic.png){:width="650px"}
224+
![Cloud project APM menu select Logs page]({{ site.baseurl }}/common/images/cloud/cloud-newrelic-dashboard-logs-access.png){:width="650px"}
225+
226+
{:.bs-callout-tip}
227+
You can also access the New Relic Logs application from the New Relic ONE home page. See [New Relic ONE core UI components][New Relic One UI].
225228

226229
1. To review infrastructure log data for cloud services, enter the query string `has: "ident"` in the _Find logs where_ field. Then, click **Query logs**.
227230
@@ -351,6 +354,7 @@ See [Alerts concepts and workflow] in the New Relic documentation for more detai
351354
[New Relic account]: #manage-your-new-relic-account
352355
[New Relic APM]: https://docs.newrelic.com/docs/apm/new-relic-apm/getting-started/introduction-new-relic-apm
353356
[New Relic APM Overview]: https://docs.newrelic.com/docs/apm/applications-menu/monitoring/apm-overview-page-view-transaction-apdex-usage-data
357+
[New Relic ONE UI]: https://docs.newrelic.com/docs/new-relic-one/use-new-relic-one/get-started/new-relic-one-core-ui-components
354358
[New Relic for application performance management (APM)]: https://docs.newrelic.com/docs/apm/new-relic-apm/getting-started/introduction-new-relic-apm
355359
[New Relic Help Center]: https://newrelic.com/
356360
[New Relic Logs]: https://docs.newrelic.com/docs/logs/new-relic-logs/get-started/introduction-new-relic-logs
90.3 KB
Loading

0 commit comments

Comments
 (0)