|
1 | | - |
2 | 1 | .. _ingest-azure-log-data: |
| 2 | +.. _azure-logs: |
3 | 3 |
|
4 | 4 | ********************************************* |
5 | | -Send Azure logs to Splunk Log Observer |
| 5 | +Send Azure logs to Splunk Platform |
6 | 6 | ********************************************* |
7 | 7 |
|
8 | 8 | .. meta:: |
9 | | - :description: Learn how to send logs from your Azure services to Splunk Observability Cloud and Splunk Log Observer using Azure Event Hub. |
10 | | - |
11 | | -.. caution:: |
12 | | - |
13 | | - Splunk Log Observer is no longer available for new users. If you have a Log Observer entitlement, you must transition to Splunk Cloud Platform or Splunk Enterprise. Read more at :ref:`lo-transition`. |
14 | | - |
15 | | - You can also use the Data Manager to send Azure logs to Splunk Platform. Learn how at :new-page:`Onboarding for Azure data in Data Manager <https://docs.splunk.com/Documentation/DM/1.8.2/User/StartConfigurationAzureAD>`. |
16 | | - |
17 | | -You can send logs from Azure to Splunk Log Observer by deploying a function that prepares and sends log data to the Splunk HTTP Event Collector (HEC) endpoint. To get started, follow these instructions. |
18 | | - |
19 | | -Prerequisites |
20 | | -================================================= |
21 | | - |
22 | | -To send logs from Azure to Splunk Observability Cloud, you need the following: |
23 | | - |
24 | | -- Access to Log Observer in Splunk Observability Cloud. See :ref:`logs-logs`. |
25 | | -- An ingest token in your organization. See :ref:`admin-org-tokens`. |
26 | | -- An Event Hub namespace in Azure to use for logs forwarding. See Event Hub in the Azure documentation. |
27 | | - |
28 | | -Create an event hub in Azure |
29 | | -================================================= |
30 | | - |
31 | | -Azure uses diagnostic settings to send data to Event Hubs. Each resource you want to monitor must have a diagnostic setting. Follow these steps to configure an event hub for each use case: |
32 | | - |
33 | | -#. In Azure, go to :guilabel:`Event Hubs` and select :guilabel:`Create`. |
34 | | - |
35 | | -#. Select your Event Hub namespace. |
36 | | - |
37 | | -#. Set the name of the event hub to one of the following values depending on which logs you want to forward: |
38 | | - |
39 | | - .. tabs:: |
40 | | - |
41 | | - .. tab:: Activity logs |
42 | | - |
43 | | - Event Hub name: ``insights-activity-logs`` |
44 | | - |
45 | | - .. note:: If you set a different hub name, update the function application settings to use the right name. |
46 | | - |
47 | | - .. tab:: Microsoft Entra ID logs (formerly Azure Active Directory) |
48 | | - |
49 | | - Event Hub name: ``insights-logs-aad`` |
50 | | - |
51 | | - .. note:: If you set a different hub name, update the function application settings to use the right name. |
52 | | - |
53 | | - .. tab:: Diagnostics logs |
54 | | - |
55 | | - Event Hub name: ``insights-logs-diag`` |
56 | | - |
57 | | - .. note:: If you set a different hub name, update the function application settings to use the right name. |
58 | | - |
59 | | - .. tab:: Metrics data |
60 | | - |
61 | | - Event Hub name: ``insights-metrics-pt1m`` |
62 | | - |
63 | | - .. note:: If you set a different hub name, update the function application settings to use the right name. |
64 | | - |
65 | | -#. Set the number of partitions. Use at least 4 partitions. |
66 | | - |
67 | | -#. Select :guilabel:`Create`. |
68 | | - |
69 | | -Configure diagnostic settings to send logs |
70 | | -=================================================== |
71 | | - |
72 | | -After you've created the event hub, follow these steps to activate diagnostic settings: |
73 | | - |
74 | | -#. In Azure, select the resource. |
75 | | - |
76 | | -#. Select :guilabel:`Monitoring`, then :guilabel:` Diagnostic settings`. |
77 | | - |
78 | | -#. Create a new setting or edit an existing setting. |
79 | | - |
80 | | -#. Select the events you want to log. |
81 | | - |
82 | | -#. Select :guilabel:`Stream to an event hub` and select the event hub you've created. |
83 | | - |
84 | | -#. Select :guilabel:`Save`. |
85 | | - |
86 | | -Set up the forwarding function in Azure |
87 | | -================================================== |
88 | | - |
89 | | -To deploy the Azure function, click the following button: |
90 | | - |
91 | | -.. raw:: html |
92 | | - |
93 | | - <a href="https://portal.azure.com/#blade/Microsoft_Azure_CreateUIDef/CustomDeploymentBlade/uri/https%3A%2F%2Fraw.githubusercontent.com%2Fsplunk%2Fazure-functions-splunk%2Fmaster%2Fevent-hubs-hec%2Fdeploy%2FazureDeploy.json/createUIDefinitionUri/https%3A%2F%2Fraw.githubusercontent.com%2Fsplunk%2Fazure-functions-splunk%2Fmaster%2Fevent-hubs-hec%2Fdeploy%2FazureDeploy.portal.json" target="_blank"><img src="https://aka.ms/deploytoazurebutton"/></a> |
94 | | - |
95 | | -In the :guilabel:`Function App Settings` section, enter the following details: |
96 | | - |
97 | | -.. list-table:: |
98 | | - :header-rows: 1 |
99 | | - :widths: 40, 60 |
100 | | - :width: 100% |
101 | | - |
102 | | - * - Setting |
103 | | - - Value |
104 | | - * - Event Hub Namespace |
105 | | - - The namespace that contains the event hub you've created. |
106 | | - * - Splunk HEC Endpoint |
107 | | - - ``https://ingest.<realm>.signalfx.com/v1/log`` where ``<realm>`` is your Splunk Observability Cloud realm. See :ref:`splunk-hec-exporter` for more information. |
108 | | - * - Splunk HEC Token |
109 | | - - Your Splunk Observability Cloud ingest token. See :ref:`admin-org-tokens`. |
110 | | - |
111 | | -.. include:: /_includes/realm-note.rst |
| 9 | + :description: Learn how to send logs from your Azure services to Splunk. |
112 | 10 |
|
113 | | -Security considerations |
114 | | -=================================================== |
| 11 | +Log collection is not available in Splunk Observability Cloud. |
115 | 12 |
|
116 | | -Azure encrypts settings by default. For increased security, you can transfer one or more of settings to a Key Vault. See the Key Vault documentation in the Azure docs for more information. |
| 13 | +Instead, you can use the Data Manager to send your Azure logs to Splunk Platform. Learn how at :new-page:`Onboarding for Azure data in Data Manager <https://docs.splunk.com/Documentation/DM/1.8.2/User/StartConfigurationAzureAD>`. To query logs, use Log Observer Connect. See more at :ref:`logs-intro-logconnect`. |
117 | 14 |
|
118 | | -Additional resources |
119 | | -================================================== |
| 15 | +If you have a Log Observer entitlement, you must transition to Splunk Cloud Platform or Splunk Enterprise. Read more at :ref:`lo-transition`. |
120 | 16 |
|
121 | | -For examples and additional information, see :new-page:`https://github.com/splunk/azure-functions-splunk/tree/master/event-hubs-hec <https://github.com/splunk/azure-functions-splunk/tree/master/event-hubs-hec>` on GitHub. |
0 commit comments