Microsoft MVP성태의 닷넷 이야기
개발 환경 구성: 511. Beats용 Kibana 기본 대시 보드 구성 방법 [링크 복사], [링크+제목 복사]
조회: 1750
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 

Beats용 Kibana 기본 대시 보드 구성 방법

예를 들어, FileBeat를 이용해 IIS 로그를 취합중인 경우 여러분들이 직접 IIS를 위한 Kibana 대시보드를 만드는 것도 가능합니다. 그렇긴 하지만 (저처럼 초보자라면) Elastic Stack에서 미리 만들어 둔 기본 대시 보드를 봐두는 것도 나쁘진 않기 때문에 테스트 용도의 ES에서는 구성할만합니다.

사실 방법도 매우 단순하고, 게다가 이미 실행 중인 Kibana가 있다면 다음의 URL에서 친절하게 설명도 해주고 있습니다.

IIS logs
; http://localhost:5601/app/home#/tutorial/iisLogs

단순히 이 글에서는 정리 차원에서 간단하게 기록을 남겨봅니다. ^^




우선, 다음과 같이 제품들을 다운로드해 압축을 풀어놓았다고 가정하면,

TESTSRV 머신:
    Elasticsearch 설치
    Kibana 설치
    
TESTCLNT 머신:
    Beat 설치

TESTCLNT의 filebeat.yml을 편집해 TESTSRV에 설치한 Elasticsearch, Kibana에 대한 경로를 (여러분들의 환경에 맞게) 적절하게 설정한 후,

output.elasticsearch:
  hosts: ["192.168.100.50:9200"]

setup.kibana:
  host: "192.168.100.50:5601"

"setup" 인자로 filebeat를 실행하면 됩니다.

C:\filebeat> filebeat.exe setup
Overwriting ILM policy is disabled. Set `setup.ilm.overwrite: true` for enabling.

Index setup finished.
Loading dashboards (Kibana must be running and reachable)
Loaded dashboards
Setting up ML using setup --machine-learning is going to be removed in 8.0.0. Please use the ML app instead.
See more: https://www.elastic.co/guide/en/machine-learning/current/index.html
Loaded machine learning job configurations
Loaded Ingest pipelines

혼동하지 말아야 할 것은, "setup" 인자로 실행되는 환경 구성은 Elasticsearch, Kibana에 대해 수행되는 것일 뿐 정작 TESTCLNT 컴퓨터 내의 FileBeat를 위한 "설치" 과정과는 무관하다는 점입니다. (물론, Filebeat.exe는 단독으로 실행 가능한 파일이므로 기타 설치 과정이 필요하지 않습니다.)

참고로, 위의 명령어는 Kibana가 제공하는 여러 종류의 기본 대시보드 유형을 한꺼번에 설정하기 때문에 이후 Kibana를 방문하면 다음과 같이 다양한 대시 보드 목록을 확인할 수 있습니다.

kibana_ext_dashboard_1.png

그중에서 아래는 "[Filebeat IIS] Access an error logs ECS" 대시보드 화면의 일부입니다.






"setup" 명령어 수행 시 다음과 같은 오류가 발생한다면?

C:\filebeat> filebeat.exe setup
Exiting: Index management requested but the Elasticsearch output is not configured/enabled

"filebeat.yml"에서 "output.logstash"로만 데이터 출력을 경유하는 구성을 하면 안 됩니다. 대신 "output.elasticsearch"로 곧바로 전달하는 구성을 해야 합니다.

또는, 다음과 같은 오류가 발생한다면?

C:\filebeat> filebeat.exe setup
Overwriting ILM policy is disabled. Set `setup.ilm.overwrite: true` for enabling.

Index setup finished.
Loading dashboards (Kibana must be running and reachable)
Exiting: error connecting to Kibana: fail to get the Kibana version: HTTP GET request to http://localhost:5601/api/status fails: fail to execute the HTTP GET request: Get "http://localhost:5601/api/status": dial tcp [::1]:5601: connectex: No connection could be made because the target machine actively refused it.. Response: .

오류 메시지에 따라 localhost의 Kibana로 접속을 시도한 것이기 때문에 "filebeat.yml"에서 "setup.kibana" 기본값을 바꿔야 합니다.

# This requires a Kibana endpoint configuration.
setup.kibana:

  # Kibana Host
  # Scheme and port can be left out and will be set to the default (http and 5601)
  # In case you specify and additional path, the scheme is required: http://localhost:5601/path
  # IPv6 addresses should always be defined as: https://[2001:db8::1]:5601
  host: "192.168.100.50:5601"

그런데, 그래도 다음과 같은 오류가 발생한다면?

C:\filebeat> filebeat.exe setup
Overwriting ILM policy is disabled. Set `setup.ilm.overwrite: true` for enabling.

Index setup finished.
Loading dashboards (Kibana must be running and reachable)
Exiting: error connecting to Kibana: fail to get the Kibana version: HTTP GET request to http://192.168.100.50:5601/api/status fails: fail to execute the HTTP GET request: Get "http://192.168.100.50:5601/api/status": dial tcp 192.168.100.50:5601: connectex: No connection could be made because the target machine actively refused it.. Response: .

Kibana가 설치된 PC에서 5601 포트로 대기하고 있는 IP를 확인해 보고,

C:\Users\kevin> netstat -ano | findstr 5601
  TCP    127.0.0.1:5601         0.0.0.0:0              LISTENING       16592

저렇게 "127.0.0.1"로 바인딩되어 있으면 외부에서 접속할 수 없으므로, Kibana가 설치된 서버에서 "kibana.yml" 파일의 "server.host" 값을 편집해야 합니다.

# 이렇게 설정한 경우, Kibana를 공용 IP로 접근할 수 있는 서버에 두었다면 누구나 접근할 수 있으므로,
# xpack을 설치해 로그인 설정을 하는 등의 보안을 해야 합니다.

server.host: "0.0.0.0"




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]



donaricano-btn



[최초 등록일: ]
[최종 수정일: 7/10/2021

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 쓴 사람
 




1  2  3  4  5  6  7  8  9  10  11  [12]  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
12459정성태12/16/2020935Linux: 35. C# - 리눅스 환경에서 클라이언트 소켓의 ephemeral port 재사용파일 다운로드1
12458정성태12/16/20201174오류 유형: 694. C# - Task.Start 메서드 호출 시 "System.InvalidOperationException: 'Start may not be called on a task that has completed.'" 예외 발생 [1]
12457정성태12/15/20201018Windows: 185. C# - Windows 10/2019부터 추가된 SIO_TCP_INFO파일 다운로드1
12456정성태12/15/20201008VS.NET IDE: 156. Visual Studio - "Migrate packages.config to PackageReference"
12455정성태12/15/2020786오류 유형: 693. DLL 로딩 시 0x800704ec - This Program is Blocked by Group Policy
12454정성태12/15/20201027Windows: 184. Windows - AppLocker의 "DLL Rules"를 이용해 임의 경로에 설치한 DLL의 로딩을 막는 방법 [1]
12453정성태12/14/20201421.NET Framework: 984. C# - bool / BOOL / VARIANT_BOOL에 대한 Interop [1]파일 다운로드1
12452정성태12/14/20201003Windows: 183. 설정은 가능하지만 구할 수는 없는 TcpTimedWaitDelay 값
12451정성태12/14/2020868Windows: 182. WMI Namespace를 열거하고, 그 안에 정의된 클래스를 열거하는 방법
12450정성태12/13/20201143.NET Framework: 983. C# - TIME_WAIT과 ephemeral port 재사용파일 다운로드1
12449정성태12/11/20201460.NET Framework: 982. C# - HttpClient에서의 ephemeral port 재사용 [2]파일 다운로드1
12448정성태12/11/20202697.NET Framework: 981. C# - HttpWebRequest, WebClient와 ephemeral port 재사용파일 다운로드1
12447정성태12/10/20201284.NET Framework: 980. C# - CopyFileEx API 사용 예제 코드파일 다운로드1
12446정성태12/10/20201195.NET Framework: 979. C# - CoCreateInstanceEx 사용 예제 코드파일 다운로드1
12445정성태12/8/20201027오류 유형: 692. C# Marshal.PtrToStructure - The structure must not be a value class.파일 다운로드1
12444정성태12/8/20201137.NET Framework: 978. C# - GUID 타입 전용의 UnmanagedType.LPStruct파일 다운로드1
12443정성태12/8/2020963.NET Framework: 977. C# PInvoke - C++의 매개변수에 대한 마샬링을 tlbexp.exe를 이용해 확인하는 방법
12442정성태12/4/20201006오류 유형: 691. Visual Studio - Build Events에 robocopy를 사용할때 "Invalid Parameter #1" 오류가 발행하는 경우
12441정성태12/4/2020853오류 유형: 690. robocopy - ERROR : No Destination Directory Specified.
12440정성태12/4/2020982오류 유형: 689. SignTool Error: Invalid option: /as
12439정성태12/4/20201205디버깅 기술: 176. windbg - 특정 Win32 API에서 BP가 안 걸리는 경우 (2)
12438정성태12/2/20201167오류 유형: 688. .Visual C++ - Error C2011 'sockaddr': 'struct' type redefinition
12437정성태12/1/20201130VS.NET IDE: 155. pfx의 암호 키 파일을 Visual Studio 없이 등록하는 방법
12436정성태12/1/20201266오류 유형: 687. .NET Core 2.2 빌드 - error MSB4018: The "RazorTagHelper" task failed unexpectedly.
12435정성태12/1/20204115Windows: 181. 윈도우 환경에서 클라이언트 소켓의 최대 접속 수 (4) - ReuseUnicastPort를 이용한 포트 고갈 문제 해결파일 다운로드1
12434정성태11/30/20201314Windows: 180. C# - dynamicport 값의 범위를 알아내는 방법
1  2  3  4  5  6  7  8  9  10  11  [12]  13  14  15  ...