> For the complete documentation index, see [llms.txt](https://help.verkada.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.verkada.com/command/ko/organization-settings/integrations/verkada-splunk-integration.md).

# Splunk

Splunk는 조직이 다양한 제3자 소스의 데이터를 검색, 모니터링, 분석할 수 있도록 돕는 소프트웨어 플랫폼입니다. 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 패키지가 설치되면 애플리케이션을 여세요. 계정 자격 증명(사용자 이름 및 비밀번호)을 만들 수 있는 터미널 또는 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.  **설치** 를 클릭하여 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. 클릭 **동의하고 설치**.
   {% endstep %}
   {% endstepper %}

***

## Splunkbase에서 소프트웨어 다운로드 및 설치

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

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

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

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

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

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

{% step %}
**앱 관리에서 오른쪽 상단의 파일에서 앱 설치를 클릭하세요.**

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

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

{% step %}
**파일에서 앱 설치에서:**

a. 다음을 클릭합니다 **파일 선택**.\
b. 다음의 **다운로드** 폴더에서 최근에 다운로드한 파일(**verkada-add-on\_126.tgz**).\
c. 파일을 선택하고 **업로드**.

<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 앱 페이지의 오른쪽 상단에서 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 키](https://apidocs.verkada.com/reference/quick-start-guide).\
f. **추가**.
{% endstep %}

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

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

{% step %}
**통합이 성공했는지 확인하세요:**

a. **검색** 탭으로 이동하세요.\
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 앱을 삭제하고 다시 설치하세요:
  1. Splunk 애플리케이션 디렉터리로 이동하세요.
  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`. 추가 기능 구성 탭에서 로깅 수준을 조정할 수 있습니다.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.