카테고리 보관물: .Net / C#

C# NLog 이용하여 WebForm, WinForm 로그 만들기

댓글 남기기

로그의 필요성

개발을 진행하면서 개발 도구를 가지고 디버깅을 하게 됩니다. WebFrom의 Javascript 부분은 console.log 로 값을 확인하거나 화면에 직접 출력해서 변수의 값을 확인합니다. 하지만 실제로 운영이 되고 있는 시스템에서 문제가 발생하면 그 상황에 대한 정보가 있어야 해결이 가능합니다. 이런 이유 때문에 로그가 필요합니다. 기본적으로는 최소화하는 것이 좋습니다. 하지만 운영 초기에는 가능한 한 로그 자료를 많이 생성합니다. 문제가 발생했을 때 해결시간을 최소화하는데 중점을 둡니다.

대부분 메소드 호출 부분에 전달된 변수의 값이나 예외의 내용을 기록합니다. 예외의 내용을 사용자에게 직접적으로 노출하지 않고 개발자가 확인할 수 있는 방법입니다.

이전에는 간단하게 텍스트 파일을 만들어 로깅을 진행했습니다. 물론 지금도 그렇게 사용해도 되지만 잘 만들어진 로그 라이브러리를 사용하는 것이 더 나은 선택입니다. 대표적인 것이 NLog, log4net 입니다. 설정이 상대적으로 쉬운 NLog 를 이용한 로깅에 대해 살펴보겠습니다.

NLog

NLog 는 무료로 사용할 수 있는 .NET용 로깅 플랫폼 입니다. 설정이 쉬운 것이 장점입니다. log4net을 사용해 본적이 있었습니다. 설정이 생각보다 쉽지는 않았던 기억이  납니다.

로그의 내용을 파일, 이벤트로그, 데이터 베이스 등에도 기록할 수 있습니다. 개발 환경에 맞게 선택해서 기록하면 됩니다. 필자는 일자별로 텍스트 파일로 기록합니다.

설치는 패키지 관리자 콘솔에서 다음 명령어를 입력하면 됩니다.

PM> Install-Package NLog.Config

WebForm(ASP.NET)

ASP.NET 프로젝트일 때 설정하는 방법을 알아보겠습니다.

설정은 파일이나 소스에 직접할 수 있습니다. 이 글에서는 파일에 설정하는 방법을 살펴보겠습니다.

NLog.config 의 내용을 수정해서 설정하면 됩니다.

<?xml version="1.0" encoding="utf-8" ?>
<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <variable name="LogDay" value="${date:format=yyyyMMdd}"/>;
    <targets>
        <target name="logfile" xsi:type="File" fileName="D:\yourserver\yourproject\log\${LogDay}.log" />
    </targets>
    <rules>
        <logger name="*" minlevel="Info" writeTo="logfile" />
    </rules>
</nlog>

3행은 일자의 형식을 지정하는 설정입니다. 20180127.log 이런식으로 파일이 생성됩니다.

5행은 실제 로그 파일이 저장될 위치입니다.

추가적인 설정은 NLog 사이트를 참고하여 필요하신 사항을 추가하시면 됩니다. 필자는 위의 설정만으로도 충분했습니다. NLog.config 파일은 web root 경로에 두시면 됩니다.

소스에서는 다음과 같이 코드를 추가해서 사용하면 됩니다.

public partial class nlog_test : System.Web.UI.Page
{
	private static Logger logger = LogManager.GetCurrentClassLogger();

	protected void Page_Load(object sender, EventArgs e)
	{
		try
		{
			logger.Info("your log text");
		}
		catch (Exception ex)
		{
			logger.Fatal("Exception occurred in Page_Load. : " + ex.Message + ";" + ex.Source);
		}
	}
}

로그 파일에는 다음과 같이 기록됩니다.

2017-12-26 00:03:46.3420|INFO||your log text
2017-12-26 00:12:27.9778|FATAL||Exception occurred in Page_Load : your error message ;mscorlib

로그 파일이 저장되는 경로가 쓰기 권한이 없으면 기록이 되지 않는 경우가 있습니다. 경로가 정확한데 로그파일이 생성되지 않는다면 인터넷 사용자(IUSR)의 쓰기 권한을 부여하시면 됩니다.

WinForm

WinForm의 경우도 설정은 같습니다. 특정한 폴더에 로그가 기록되도록 하고 싶으면 위와 같이 설정하시면 됩니다. 프로그램이 실행된 폴더의 하위에 생성되도록 하고 싶다면 다음과 같이 설정합니다.

<?xml version="1.0" encoding="utf-8" ?>
<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <variable name="LogDay" value="${date:format=yyyyMMdd}"/>
    <targets>
        <target name="logfile" xsi:type="File" fileName="log\${LogDay}.log" />
    </targets>
    <rules>
        <logger name="*" minlevel="Info" writeTo="logfile" />
    </rules>
</nlog>

이렇게 하면 프로그램이 실행된 폴더의 하위에 log 폴더가 생성되고 그 안에 날짜별로 로그파일이 생성됩니다.
NLog.config 파일은 실행파일이 있는 경로에 두시면 됩니다.

이상 NLog를 이용한 로깅에 대해 알아봤습니다.

C#을 이용한 네이버 오픈 API 연동

댓글 남기기

들어가는 말

요즈음은 포털 사이트에서 Open API를 제공하여 검색의 결과나 다른 정보를 가져와서 필요에 맞게 구성할 수 있게 되었습니다. Open API를 사용하여 그 결과를 가져오는 방법이 언어에 따라 차이가 있는데 C#을 이용한 네이버 오픈 API 연동 에 관하여 알아보도록 하겠습니다.

연동설정 및 대상

먼저 네이버에 애플리케이션을 등록하여야 하는데 이 과정은 아래의 링크를 참고 하시면 됩니다.

https://developers.naver.com/apps/#/register?defaultScope=search

연동에 필요한 기본적인 설정은 되어 있다고 가정하겠습니다. 서비스 API > 검색에서 여러 영역이 있는데 카페글을 대상으로 진행해 보겠습니다. 웹문서, 블로그 등도 비슷한 방식으로 연동하시면 됩니다.

연동방법

C#에서는 WebRequest 클래스를 이용하여 Open API와 연동합니다. 레퍼런스는 아래의 링크에서 확인하실 수 있습니다.

https://msdn.microsoft.com/ko-kr/library/system.net.webrequest(v=vs.110).aspx

연동 자체는 어렵지 않습니다. 다음과 같은 방식으로 결과를 가져옵니다. GetRequestResult 메소드는 네이버 오픈 API URL, 클라이언트 ID와 secret을 전달받아 그 결과를 string으로 반환합니다.

private string GetRequestResult(string openApiUrl, string clientId, string clientSecret)
{
	var requestResult = String.Empty;

	try
	{
		WebRequest request = null;

		request = WebRequest.Create(openApiUrl);

		request.Headers.Add("X-Naver-Client-Id", clientId);
		request.Headers.Add("X-Naver-Client-Secret", clientSecret);

		Stream dataStream = null;

		var response = request.GetResponse();
		dataStream = response.GetResponseStream();
		var reader = new StreamReader(dataStream);
		requestResult = reader.ReadToEnd();
		reader.Close();
		dataStream.Close();
		response.Close();
	}
	catch (Exception ex)
	{
		logger.Fatal("Exception occurred!");
	}

	return requestResult;
}

13, 14행에 클라이언트 ID와 secret를 지정해 주고 openApiUrl은

https://openapi.naver.com/v1/search/cafearticle.json?query=키워드&display=40

와 같은 형태로 지정합니다. 요청 변수 및 출력결과에 대한 설명은 아래의 링크에서 확인하실 수 있습니다.

https://developers.naver.com/docs/search/cafearticle/

결과 반환형식은 XML 또는 JSON으로 지정할 수 있습니다. 사용하기 편한 형태로 지정하여 사용하면 됩니다. 필자는 JSON 형태로 지정하여 결과값을 받았습니다. 그 값을 JSON Parser(Newtonsoft.Json)를 이용하여 parsing 후 값을 가져왔습니다. 예를 들면 다음과 같습니다.

responseJSON = GetRequestResult(openApiUrl, clientId, clientSecret);

var parseJSON = JObject.Parse(responseJSON);

var queryResultCount = Convert.ToInt32(parseJSON["display"]); //검색된 검색 결과의 개수
var totalResultCount = Convert.ToInt32(parseJSON["total"]); //검색 결과 문서의 총 개수

//개별 검색 결과
var cafeTitle = parseJSON["items"][0]["title"].ToString();
var cafeContent = parseJSON["items"][0]["description"].ToString();
var cafeName = parseJSON["items"][0]["cafename"].ToString();
var cafeUrl = parseJSON["items"][0]["cafeurl"].ToString();

5행은 parsing하여 변수에 대입하는 코드이고 나머지는 몇 가지 요소의 값을 가져오는 코드입니다. 위의 링크의 출력 결과 정보와 함께 보시면 됩니다. 링크의 설명에는 개별 검색 결과의 필드가 item 이라고 되어 있는데 실제 결과를 받아보니 items 로 되어 있었습니다. 원하는 값을 가져올 수 없는 경우 반환값의 필드명이 다른 것이 아닌지 확인할 필요가 있습니다.

이상으로 C#을 이용한 네이버 오픈 API 연동 방법에 대하여 알아보았습니다.