Asterisk-queue
Overview
Asterisk queue 명령어 정리
Basic
queue 명령어는 생성되어 있는 Queue 의 멤버 및 현재 상황 정보를 확인/추가/수정/삭제 할 때 사용하는 명령어이다.
Channel state
Asterisk 의 Queue 는 디바이스(채널)의 상태 정보에 따라 민감하게 반응한다. 이런 이유로, 각각의 Asterisk 에서 Queue 에 채널을 추가하기 위해서는 먼저 채널 드라이버에서 Queue 모듈에 적절한 상태정보를 줄 수 있는지를 확인해야 한다. 하지만, 각각의 채널드라이버(SIP, IAX, ...)에서 사용되는 채널의 상태 정보들이 다를 수 있다. 그리고, 각각의 모듈에서 Queue 로 채널(디바이스)상태 정보를 전달할 수 있도록 하는 적절한 옵션을 설정해줘야 한다.
chan_sip.so 모듈의 경우, sip.conf 파일에 다음 옵션을 활성화해야 한다.
[general] callcounter=yes ; enable device states for SIP devices
Create Queue
Queue 의 생성 및 삭제 를 위해서는 queues.conf 설정파일을 수정해야한다. cli 로는 생성/삭제가 불가능하다.
자세한 내용은 Asterisk-queues.conf를 참고하면 된다.
Module
Queue 모듈 load/unload/reload 를 위해서는 다음의 명령어를 입력하면 된다.
pluto*CLI> module load app_queue.so pluto*CLI> module unload app_queue.so pluto*CLI> module reload app_queue.so
help
pluto*CLI> help queue queue add member -- Add a channel to a specified queue queue reload {parameters|members|rules|all} -- Reload queues, members, queue rules, or parameters queue remove member -- Removes a channel from a specified queue queue reset stats -- Reset statistics for a queue queue set penalty -- Set penalty for a channel of a specified queue queue set ringinuse -- Set ringinuse for a channel of a specified queue queue show -- Show status of a specified queue queue show rules -- Show the rules defined in queuerules.conf queue {pause|unpause} member -- Pause or unpause a queue member
show
현재 등록된 모든 queue 정보를 확인한다. show 뒤에 특정 Queue 이름을 입력하면 입력된 queue에 대한 내용만 나타난다. 큐/멤버/콜 세가지 항목으로 구분되어 나타낸다.
vpbx11*CLI> queue show Camp200 Camp200 has 1 calls (max unlimited) in 'ringall' strategy (0s holdtime, 0s talktime), W:100, C:0, A:2, SL:0.0% within 0s Members: user1 (Local/200@DialCamp) (Ringing) has taken 1 calls (last was 6 secs ago) Callers: 1. SIP/201-test-1-0000001b (wait: 0:03, prio: 0)
Queue info
큐 정보를 나타낸다.
- Camp200 : 큐 이름.
- has 1 calls : 현재 큐에 인입되어 분배 대기중인 콜의 갯수.
- (max unlimited) : 큐에 인입되어 대기 가능한 최대 콜의 갯수.
- 'ringall' stratergy : 큐에 설정된 콜 분배 방식.
- 0s holdtime : 큐에 인입되는 콜들의 분배되기까지의 평균 대기 시간.
- 0s talktime : 큐에 인입되는 콜들의 분배 후 평균 통화 시간.
- W : 큐 가중치. 하나의 상담원(채널)이, 여러개의 큐에 대기중이고, 여러개의 큐에 동시에 콜이 인입되었을 경우, 가중치가 높은(많은) 수록, 큐에 인입된 콜이 먼저 분배될 확률이 높아진다.
- C : 큐에 인입되어 정상적으로 분배된 콜 수.
- A : 큐에 인입되었지만 정상적으로 분배되지 못한 콜 수.
- SL : Service level check interval 시간동안 인입된 콜의 정상 분배율 %.
- within 0s : Service level check interval
Members info
큐에 등록된 멤버 정보를 나타낸다.
- user1 : Username
- (Local/200@DialCamp) : 큐에 등록된 채널 정보
- (Ringing) : 채널 state
- taken 1 calls : 수신한 콜 갯수. 받은 콜수가 0일 경우, "taken no calls yet" 이라고 나타난다.
- (last was 6 secs ago) : 마지막으로 분배받아서 통화 종료한 콜 시각으로부터의 시간.
Callers
현재 분배 대기중인 콜의 내용을 나타낸다.
- 1. index 번호
- SIP/201-test-1-0000001b : 큐에 인입된 Channel 이름.
- wait: 0:03 : 큐에 인입되어 대기중인 시간
- prio: 우선순위 가중치. 높은 우선순위 가중치를 가진 콜(채널) 일 수록, 분배가 빨리 된다.
add member
queue 에 Member 를 추가한다.
*CLI> queue add member <channel> to <queue> [[[penalty <penalty>] as <membername>] state_interface <interface>]
- <channel> : Queue 에 추가하고자 하는 channel 정보. SIP/0000FFFF0003 과 같은 정보를 말한다.
- <queue> : 멤버가 추가될 Queue 이름.
- <penalty> : 추가되는 멤버가 가지게 될 패널티
- <membername> : 추가되는 멤버에 설정하고자 하는 이름
- state_interface : 추가되는 채널의 상태정보를 설정한다
*CLI> queue add member SIP/0000FFFF0001 to support Added interface 'SIP/0000FFFF0001' to queue 'support' *CLI> queue show support support has 0 calls (max unlimited) in 'rrmemory' strategy (0s holdtime, 0s talktime), W:0, C:0, A:0, SL:0.0% within 0s Members: SIP/0000FFFF0001 (dynamic) (Not in use) has taken no calls yet No Callers
remove member
queue에서 멤버를 삭제한다.
queue remove member SIP/0000FFFF0001 from support Removed interface 'SIP/0000FFFF0001' from queue 'support'
pause
queue 에 설정된 멤버를 일시정지 한다
*CLI> queue pause member SIP/0000FFFF0001 queue support reason DoingCallbacks paused interface 'SIP/0000FFFF0001' in queue 'support' for reason 'DoingCallBacks' *CLI> queue show support support has 0 calls (max unlimited) in 'rrmemory' strategy (0s holdtime, 0s talktime), W:0, C:0, A:0, SL:0.0% within 0s Members: SIP/0000FFFF0001 (dynamic) (paused) (Not in use) has taken no calls yet No Callers
unpause
일시정지 되어 있는 멤버를 다시 복귀시킨다.
*CLI> queue unpause member SIP/0000FFFF0001 queue support reason off-break unpaused interface 'SIP/0000FFFF0001' in queue 'support' for reason 'off-break' *CLI> queue show support support has 0 calls (max unlimited) in 'rrmemory' strategy (0s holdtime, 0s talktime), W:0, C:0, A:0, SL:0.0% within 0s Members: SIP/0000FFFF0001 (dynamic) (Not in use) has taken no calls yet No Callers