# Splunk

Splunk은 조직이 다양한 타사 소스의 데이터를 검색, 모니터링, 분석할 수 있도록 돕는 소프트웨어 플랫폼입니다. Verkada는 사용자가 내장 통합을 통해 Command 조직의 정보를 Splunk 인스턴스로 전송하는 효율적인 워크플로를 구축할 수 있게 해줍니다.

Verkada를 Splunk와 통합하면 비디오 감시 데이터를 운영 데이터의 더 넓은 맥락 안에서 중앙 집중화하고 분석할 수 있어 더 나은 인사이트와 의사 결정을 가능하게 합니다. 이 구현을 사용하면 장치 알림을 포함하여 조직의 모든 카메라에서 사람 및 차량 수를 가져올 수 있습니다.

{% hint style="danger" %}
시작하기 전에 다음이 필요합니다:

* 관리자(Admin) 액세스 권한이 있는 활성 Splunk 인스턴스. 자세한 내용은 [Command의 역할 및 권한](/command/ko/users-and-permissions/roles-and-permissions-for-command.md).
* Verkada 조직에 대한 Org Admin 권한.
* 유효한 Verkada API 키. 생성 방법을 알아보려면 [Verkada API 키 생성](https://apidocs.verkada.com/reference/quick-start-guide)
  {% endhint %}

통합을 설정하는 방법은 2가지가 있습니다:

* [Splunk Enterprise 소프트웨어 다운로드 및 설치](#h_c45403a4de)
* [Splunkbase에서 소프트웨어를 다운로드하여 설치](#h_7b8e057156)

***

## Splunk Enterprise 소프트웨어 다운로드 및 설치

{% stepper %}
{% step %}
**다음에서 Splunk Enterprise 소프트웨어를 다운로드하세요** [**https://www.splunk.com/en\_us/download.html**](https://www.splunk.com/en_us/download.html)**. 이미 Splunk Enterprise 계정을 설치 및 설정했다면 4단계로 진행하세요.**

<div align="left" data-with-frame="true"><img src="/files/792be96bd4eba76d3a2bf28e11b7d9ee20f5051a" alt="" width="800"></div>
{% endstep %}

{% step %}
**사용 중인 운영 체제(Windows, Linux 또는 MacOS)에 따라 해당 설치 패키지를 선택하세요. 더 쉬운 설정 과정을 위해 .dmg 패키지 다운로드를 권장합니다.**

<div align="left" data-with-frame="true"><img src="/files/7f67a80ec602e11ed45b7c716214a1161e48befc" alt="" width="800"></div>
{% endstep %}

{% step %}
**Splunk Enterprise 패키지가 설치되면 애플리케이션을 여세요. 계정 자격 증명(사용자 이름 및 비밀번호)을 생성할 수 있는 Terminal 또는 PowerShell 창으로 이동하게 됩니다.**

​\
​**중요**: 이 자격 증명을 보관하세요. 나중에 Splunk에 로그인하고 Verkada 통합을 설정할 때 필요합니다. 계정을 생성하면 계정 인증을 위한 이메일을 받게 됩니다. 받은 편지함을 확인하고 설정 과정을 진행하기 전에 이 단계를 완료하세요.
{% endstep %}

{% step %}
**사용자 이름과 비밀번호를 설정하면 Splunk 애플리케이션이 자동으로 열려야 합니다. 3단계에서 설정한 자격 증명으로 로그인하세요. Splunk Enterprise 창이 열리지 않으면 다음 URL로 이동하여 로그인하세요:**

​\ <kbd><http://localhost:8000/en-US/account/login?return\\_to=%2Fen-US%2Fapp%2Flauncher%2Fhome></kbd>

<div align="left" data-with-frame="true"><img src="/files/e38634974a0c515ca3acf7cfcdbf8579dce14167" alt="" width="753"></div>

Splunk 홈페이지는 Verkada를 포함한 다양한 통합을 위한 모든 애플리케이션이 관리 및 구성되는 곳입니다.
{% endstep %}

{% step %}
**왼쪽 상단에서 Apps 드롭다운을 클릭하고 Find more apps를 선택하세요.**

<div align="left" data-with-frame="true"><img src="/files/d94695326fa9242c099db71bdc4bf35f16ee7abb" alt="" width="800"></div>
{% endstep %}

{% step %}
**Browse More Apps에서:**

a. 검색 상자에 다음을 입력하세요 **Verkada**. 그러면 2개의 애플리케이션이 표시됩니다.\
b. 가장 최근에 업데이트된 Verkada 애플리케이션(**verkada add-on**)을 설치하세요.\
c. 다음을 클릭하세요 **Install** Verkada 앱에 대해.

<div align="left" data-with-frame="true"><img src="/files/eae0ff87c28f882f14277ccf408de96b13ab3415" alt="" width="800"></div>
{% endstep %}

{% step %}
**Login and Install에서:**

1. 계정 인증을 위해 Splunk 계정 자격 증명을 입력하세요.

{% hint style="info" %}
이 자격 증명은 3단계에서 생성한 것과 다릅니다. 앱을 설치하려면 일반 Splunk 계정에 로그인할 때 사용한 이메일과 비밀번호를 사용하세요. (<https://www.splunk.com/>).
{% endhint %}

2. 다음을 클릭합니다. **Agree and Install**.
   {% endstep %}
   {% endstepper %}

***

## Splunkbase에서 소프트웨어를 다운로드하여 설치

다음 [위의 설치 방법](#h_c45403a4de) 이 작동하지 않으면, 여기에서 설명하는 대체 방법이 있습니다.

{% stepper %}
{% step %}
**앱을 다음에서 다운로드하세요** [**https://splunkbase.splunk.com/app/6971**](https://splunkbase.splunk.com/app/6971)**.**
{% endstep %}

{% step %}
**Download를 클릭하여 Verkada add-on 애플리케이션을 다운로드하세요.**

<div align="left" data-with-frame="true"><img src="/files/335f30dfa3da2c43b39411265d41472556d0f343" alt="" width="800"></div>
{% endstep %}

{% step %}
**패키지가 다운로드되면:**

a. Splunk Enterprise 계정으로 돌아가세요.\
b. 다음 아래에서 **Apps** 드롭다운에서 **Manage Apps**.
{% endstep %}

{% step %}
**Manage Apps에서 오른쪽 상단의 Install app from file을 클릭하세요.**

<div align="left" data-with-frame="true"><img src="/files/8e6d8197850666d9da53a353a6c564876c3f3f5a" alt="" width="1727"></div>
{% endstep %}

{% step %}
**그러면 Splunk 인스턴스에 추가하려는 애플리케이션의 설치 파일을 선택하라는 새 페이지로 이동합니다.**
{% endstep %}

{% step %}
**Install App From File에서:**

a. **Choose File**.\
b. 다음의 **Downloads** 폴더에서 최근에 다운로드한 파일(**verkada-add-on\_126.tgz**)을 찾으세요.\
c. 파일을 선택하고 다음을 클릭하세요 **Upload**.

<div align="left" data-with-frame="true"><img src="/files/a0b42af281cd13965cd552eef8bcc03447a7d5d5" alt="" width="691"></div>
{% endstep %}

{% step %}
**앱이 다운로드되면 Apps 아래에서 홈페이지에 Verkada Add-On 탭이 표시되어야 합니다.**

<div align="left" data-with-frame="true"><img src="/files/ca1bcb0d7e53b604900d47d58529611c0dbecd95" alt="" width="800"></div>
{% endstep %}

{% step %}
**Verkada Add-On 탭을 클릭하세요. 그러면 Verkada 통합을 설정하고 관리할 수 있는 새 페이지로 이동합니다.**

<div align="left" data-with-frame="true"><img src="/files/ef02be2149390634369f44cbd811081db88e39bf" alt="" width="1728"></div>
{% endstep %}

{% step %}
**Verkada App 페이지의 오른쪽 상단에서 Add Input을 클릭하세요. 그러면 2가지 다른 유형의 입력을 만들 수 있습니다:**

* **verkada\_insights** 는 조직의 각 카메라에 대한 객체 감지 정보를 제공합니다. 정기적으로 예약된 간격마다 감지된 사람과 차량 수, 그리고 해당 수에 대한 타임스탬프를 표시합니다.
* **verkada\_notifications** 는 Verkada 장치에서 생성된 모든 알림의 전체 목록을 제공합니다.
  {% endstep %}

{% step %}
**Verkada의 Splunk 통합에 대한 사용 사례에 따라 verkada\_insights, verkada\_notifications 또는 둘 다에 대한 새 입력을 만드세요.**

{% hint style="warning" %}
​두 옵션 모두에 대한 결과를 생성하려면 각 기능에 대해 2개의 개별 입력을 만들어야 합니다.\
​
{% endhint %}
{% endstep %}

{% step %}
**입력을 선택하면 다음 설정을 입력하라는 메시지가 표시됩니다:**

a. 데이터 입력의 고유 이름\
b. 각 처리된 입력의 시간 간격(초)\
c. 인덱스(권장 **기본값**)\
d. Verkada Command 조직 ID\
e. 귀하의 [Verkada API key](https://apidocs.verkada.com/reference/quick-start-guide).\
f. 다음을 클릭하세요 **Add**.
{% endstep %}

{% step %}
**이 새 데이터 입력을 추가하면 11단계에서 만든 이름과 함께 Verkada 앱의 Input 탭에서 확인할 수 있습니다.**

<div align="left" data-with-frame="true"><img src="/files/2a4ff19c1dbd14225666a5360450d74cadd3d8cc" alt="" width="800"></div>
{% endstep %}

{% step %}
**통합이 성공했는지 확인합니다:**

a. 다음으로 이동하세요 **Search** 탭.\
b. 다음을 입력하세요 **source="verkada\_insights"** 또는 **source="verkada\_notifications"**, 구성한 데이터 입력에 따라 다릅니다.

<div align="left" data-with-frame="true"><img src="/files/f63c82d194368b3f72fb1ac1c2d616d1b66f6794" alt=""></div>

<div align="left" data-with-frame="true"><img src="/files/96e9e0a41d2cdaf18c6c641092f6f6c660704a56" alt=""></div>

<div align="left" data-with-frame="true"><img src="/files/fe0149ecc30b8386111814141dd19fcac619c6dd" alt=""></div>
{% endstep %}
{% endstepper %}

***

## 문제 해결

버전 1.1.0에서 버전 1.2.6으로 업데이트할 때 일부 새 입력이 즉시 표시되지 않을 수 있습니다. 이 경우 아래 단계를 따라 문제를 해결하세요:

* Splunk 인스턴스를 재시작한 후 계정에 다시 로그인하세요.
* 3개의 입력이 여전히 표시되지 않으면 Verkada Add-On App을 삭제하고 다시 설치하세요:
  1. Splunk Application 디렉터리로 이동하세요.
  2. 다음 폴더를 삭제하세요 `SPLUNK_HOME/etc/apps/TA-verkada-add-on`.

{% hint style="info" %}
변경 사항이 적용되려면 Splunk 인스턴스를 다시 시작해야 할 수 있습니다.
{% endhint %}

3. Splunk에서 Verkada Add-On 애플리케이션을 다운로드하려면 이 설정 가이드의 1단계로 돌아가세요.
4. 이제 Verkada 애플리케이션 아래에서 새 입력을 볼 수 있어야 합니다.

데이터 수집 오류로 이어질 수 있는 다른 일반적인 문제가 있을 수 있습니다:

* 만료된 Verkada API 키.
* 잘못된 Command Organization ID

진행 중인 통합 문제를 더 자세히 보고 이해하려면 사용자는 다음에 위치한 전체 Splunk 로그에 액세스할 수 있습니다 `SPLUNK_HOME/var/log/splunk`. add-on 구성 탭에서 로깅 수준을 조정할 수 있습니다.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.verkada.com/command/ko/organization-settings/integrations/verkada-splunk-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.