[{"data":1,"prerenderedAt":375},["ShallowReactive",2],{"\u002Fdocs\u002Fgetting-started":3,"docs-nav":343},{"id":4,"title":5,"body":6,"description":335,"extension":336,"meta":337,"navigation":338,"path":339,"seo":340,"stem":341,"__hash__":342},"docs\u002Fdocs\u002F2.getting-started.md","Getting started",{"type":7,"value":8,"toc":327},"minimark",[9,13,18,21,110,121,129,132,136,165,278,291,295,298,309,312,315,319],[10,11,12],"p",{},"Redrive talks to RabbitMQ over two protocols: the management API for topology and stats, and AMQP for reading and writing messages. One connection entry configures both.",[14,15,17],"h2",{"id":16},"add-a-connection","Add a connection",[10,19,20],{},"Redrive opens on the connections list. Create a connection and fill in the form:",[22,23,24,37],"table",{},[25,26,27],"thead",{},[28,29,30,34],"tr",{},[31,32,33],"th",{},"Field",[31,35,36],{},"What it's for",[38,39,40,49,57,78,94,102],"tbody",{},[28,41,42,46],{},[43,44,45],"td",{},"Display name",[43,47,48],{},"The name shown in Redrive's connection list.",[28,50,51,54],{},[43,52,53],{},"Host",[43,55,56],{},"The broker's hostname or IP address. Both protocols connect to it.",[28,58,59,62],{},[43,60,61],{},"AMQP port",[43,63,64,65,69,70,73,74,77],{},"The messaging port, ",[66,67,68],"code",{},"5672"," by default. The TLS switch beside it is for ",[66,71,72],{},"amqps"," listeners, usually on ",[66,75,76],{},"5671",".",[28,79,80,83],{},[43,81,82],{},"Management API",[43,84,85,86,89,90,93],{},"Scheme and port of the management plugin, ",[66,87,88],{},"http"," on ",[66,91,92],{},"15672"," by default.",[28,95,96,99],{},[43,97,98],{},"Username and Password",[43,100,101],{},"One broker account, used for both the management API and AMQP.",[28,103,104,107],{},[43,105,106],{},"Trust any certificate",[43,108,109],{},"Skips certificate checks on both protocols. For development brokers with self-signed certificates; leave it off anywhere else.",[10,111,112,113,116,117,120],{},"Paste an ",[66,114,115],{},"amqp:\u002F\u002F"," or ",[66,118,119],{},"amqps:\u002F\u002F"," URI anywhere in the form and Redrive prefills the host, port, TLS setting, and credentials from it.",[10,122,123,124,77],{},"Redrive encrypts the broker password before storing it. Where the encryption key lives is covered in ",[125,126,128],"a",{"href":127},"\u002Fdocs\u002Fsecurity","Security",[10,130,131],{},"Saving does not test the connection. The connections list probes the management API and AMQP separately and shows a status chip for each, so a wrong port or a rejected password surfaces there.",[14,133,135],{"id":134},"permissions","Permissions",[10,137,138,139,142,143,142,146,149,150,153,154,142,157,160,161,164],{},"Every operation runs as the account you saved. Browsing goes through the management API, which requires a management tag (",[66,140,141],{},"management",", ",[66,144,145],{},"monitoring",[66,147,148],{},"policymaker",", or ",[66,151,152],{},"administrator"," all qualify) and enforces the same ",[66,155,156],{},"configure",[66,158,159],{},"write",", and ",[66,162,163],{},"read"," vhost permissions as AMQP.",[22,166,167,180],{},[25,168,169],{},[28,170,171,174,177],{},[31,172,173],{},"Operation",[31,175,176],{},"Protocol",[31,178,179],{},"The account needs",[38,181,182,192,205,216,227,242,254,265],{},[28,183,184,187,189],{},[43,185,186],{},"Browse queues, exchanges, and stats",[43,188,82],{},[43,190,191],{},"A management tag; read-only permissions are enough",[28,193,194,197,200],{},[43,195,196],{},"Peek",[43,198,199],{},"AMQP",[43,201,202,204],{},[66,203,163],{}," on the queue",[28,206,207,210,212],{},[43,208,209],{},"Purge",[43,211,199],{},[43,213,214,204],{},[66,215,163],{},[28,217,218,221,223],{},[43,219,220],{},"Discard",[43,222,199],{},[43,224,225,204],{},[66,226,163],{},[28,228,229,232,234],{},[43,230,231],{},"Redrive",[43,233,199],{},[43,235,236,238,239,241],{},[66,237,163],{}," on the queue and ",[66,240,159],{}," on the default exchange",[28,243,244,247,249],{},[43,245,246],{},"Publish",[43,248,199],{},[43,250,251,253],{},[66,252,159],{}," on the exchange",[28,255,256,259,261],{},[43,257,258],{},"Delete a queue",[43,260,82],{},[43,262,263,204],{},[66,264,156],{},[28,266,267,270,272],{},[43,268,269],{},"Add or remove a binding",[43,271,82],{},[43,273,274,238,276,253],{},[66,275,159],{},[66,277,163],{},[279,280,281],"blockquote",{},[10,282,283,287,288,290],{},[284,285,286],"strong",{},"A monitoring-tagged, read-only account is enough to browse a MassTransit error-queue topology."," Grant ",[66,289,159],{}," permissions only on the vhosts you redrive from.",[14,292,294],{"id":293},"find-your-way-around","Find your way around",[10,296,297],{},"The overview shows what the broker is running: product and version, cluster name, node, and totals for connections, channels, exchanges, queues, and consumers. A queued-messages chart tracks the total, ready, and unacknowledged counts as Redrive polls. Under it, each virtual host is listed with its message count; select one to open its queues.",[10,299,300,301,304,305,308],{},"The queue list has a name filter and chips that narrow it to error queues, idle queues, or queues without consumers. Group by service folds each queue together with its ",[66,302,303],{},"_error"," and ",[66,306,307],{},"_skipped"," siblings, following the MassTransit endpoint naming convention. Each row carries a publish-rate sparkline.",[10,310,311],{},"Opening a queue shows three tabs: overview, messages, and bindings. Peek, on the messages tab, reads a batch of messages over AMQP and requeues them, so nothing is consumed.",[10,313,314],{},"Select a peeked message to inspect it. Redrive shows the parsed MassTransit envelope when it finds one, the raw body, the AMQP headers, and the fault details MassTransit recorded when the message failed.",[14,316,318],{"id":317},"next","Next",[10,320,321,322,326],{},"Continue to ",[125,323,325],{"href":324},"\u002Fdocs\u002Fredriving","Redriving"," to move messages out of an error queue.",{"title":328,"searchDepth":329,"depth":329,"links":330},"",2,[331,332,333,334],{"id":16,"depth":329,"text":17},{"id":134,"depth":329,"text":135},{"id":293,"depth":329,"text":294},{"id":317,"depth":329,"text":318},"Connect your first broker and find your way around.","md",{},true,"\u002Fdocs\u002Fgetting-started",{"title":5,"description":335},"docs\u002F2.getting-started","_avtTjVpv4Px5h9Kb9nrglkYSoNGZS_H_OT1WKB-Gcw",[344],{"title":345,"path":346,"stem":347,"children":348,"page":374},"Docs","\u002Fdocs","docs",[349,353,354,358,360,364,368,372],{"title":350,"path":351,"stem":352},"Install","\u002Fdocs\u002Finstall","docs\u002F1.install",{"title":5,"path":339,"stem":341},{"title":355,"path":356,"stem":357},"Queues & messages","\u002Fdocs\u002Fqueues","docs\u002F3.queues",{"title":325,"path":324,"stem":359},"docs\u002F4.redriving",{"title":361,"path":362,"stem":363},"Publishing & topology","\u002Fdocs\u002Fpublishing","docs\u002F5.publishing",{"title":365,"path":366,"stem":367},"Configuration","\u002Fdocs\u002Fconfiguration","docs\u002F6.configuration",{"title":369,"path":370,"stem":371},"Deployment","\u002Fdocs\u002Fdeployment","docs\u002F7.deployment",{"title":128,"path":127,"stem":373},"docs\u002F8.security",false,1787068526939]